[PHP-DOC] cvs: phpdoc /ja/functions array.xml classobj.xml datetime.xml exec.xml filesystem.xml info.xml misc.xml strings.xml var.xml /ja/language control-structures.xml From: Rui Hirokawa (louis <email protected>)
Date: 07/12/00

hirokawa Wed Jul 12 15:13:29 2000 EDT

  Modified files:
    /phpdoc/ja/functions array.xml classobj.xml datetime.xml exec.xml
                                filesystem.xml info.xml misc.xml strings.xml
                                var.xml
    /phpdoc/ja/language control-structures.xml
  Log:
  updated some translations.
  
Index: phpdoc/ja/functions/array.xml
diff -u phpdoc/ja/functions/array.xml:1.4 phpdoc/ja/functions/array.xml:1.5
--- phpdoc/ja/functions/array.xml:1.4 Sun Jul 2 01:58:02 2000
+++ phpdoc/ja/functions/array.xml Wed Jul 12 15:13:29 2000
@@ -201,15 +201,162 @@
        "b", "shape" => "trapezoid", 4)となります。
       </para>
      </example>
- <note>
+ </para>
+ <para>
+ <function>array_merge_recursive</function>も参照下さい。
+ </para>
+ </refsect1>
+ </refentry>
+
+ <refentry id="function.array-merge-recursive">
+ <refnamediv>
+ <refname>array_merge_recursive</refname>
+ <refpurpose>二つ以上の配列を再帰的にマージする</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>説明</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>array <function>array_merge_recursive</function></funcdef>
+ <paramdef>array <parameter>array1</parameter></paramdef>
+ <paramdef>array <parameter>array2</parameter></paramdef>
+ <paramdef>
+ <parameter><optional> ...</optional></parameter>
+ </paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ <function>array_merge_recursive</function>は、 二つ以上の配列の要
+ 素をマージし、前の配列の最後にもう一つの配列の値を追加します。
+ マージした後の配列を返します。
+ </para>
+ <para>
+ 入力配列が同じ文字列のキーを有している場合、これらのキーの値は配
+ 列に一つのマージされます。これは再帰的に行われます。
+ このため、値の一つが配列自体を指している場合、この関数は別の配列
+ の対応するエントリもマージします。しかし、配列が同じ数値キーを有
+ している場合、後の値は元の値を上書せず、追加されます。
+ </para>
+ <para>
+ <example>
+ <title><function>array_merge_recursive</function>の例</title>
+ <programlisting role="php">
+$ar1 = array("color" => array("favorite" => "red"), 5);
+$ar2 = array(10, "color" => array("favorite" => "green", "blue"));
+$result = array_merge_recursive($ar1, $ar2);
+ </programlisting>
       <para>
- この関数は、PHP 4.0で追加されました。
+ 返される配列は、array("color" => array("favorite" =>
+ array("red", "green"), "blue"), 5, 10)となります。
       </para>
- </note>
+ </example>
     </para>
+ <para>
+ <function>array_merge</function>も参照下さい。
+ </para>
    </refsect1>
   </refentry>
-
+
+ <refentry id="function.array-multisort">
+ <refnamediv>
+ <refname>array_multisort</refname>
+ <refpurpose>複数の多次元の配列をソートする</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>説明</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>bool <function>array_multisort</function></funcdef>
+ <paramdef>array <parameter>ar1</parameter></paramdef>
+ <paramdef>mixed
+ <parameter><optional>arg</optional></parameter>
+ </paramdef>
+ <paramdef>
+ <parameter><optional>...</optional></parameter>
+ </paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ <function>array_multisort</function>は、複数の配列を一度に、また
+ は、多次元の配列をその次元の一つでソートする際に使用可能です。
+ この関数は、ソートの際にキーの相関を維持します。
+ </para>
+ <para>
+ 入力の配列は、あるテーブルのカラムで行をソートする処理が行われま
+ す。これは、SQL ORDER BY構文と似ています。最初の配列はソートされ
+ る最初の配列です。その配列の行が同じだった場合は、次の入力配列で
+ ソートされるといったようになります。
+ </para>
+ <para>
+ この関数の引数の構造は、やや一般的ではありませんが、柔軟なもので
+ す。先頭の引数は、配列である必要があります。その後の各引数には、
+ 配列または次のリストにあるソート用フラグのどちらかを指定すること
+ が可能です。
+ </para>
+ <para>
+ ソート方法指定フラグ:
+ <itemizedlist>
+ <listitem>
+ <simpara>SORT_ASC - 昇順にソート</simpara>
+ </listitem>
+ <listitem>
+ <simpara>SORT_DESC - 降順にソート</simpara>
+ </listitem>
+ </itemizedlist>
+ </para>
+ <para>
+ ソート型のフラグ:
+ <itemizedlist>
+ <listitem>
+ <simpara>SORT_REGULAR - 普通に比較</simpara>
+ </listitem>
+ <listitem>
+ <simpara>SORT_NUMERIC - 数値的に比較</simpara>
+ </listitem>
+ <listitem>
+ <simpara>SORT_STRING - 文字列として比較</simpara>
+ </listitem>
+ </itemizedlist>
+ </para>
+ <para>
+ 各配列に同じ型のソート用フラグを二つ指定することは出来ません。
+ ある引数配列に適用を指定されたソート用フラグが適用されるのは、そ
+ の配列のみです。新しい配列引数を処理する前にデフォルトのSORT_ASC
+ およびSORT_REGULARにリセットします。
+ </para>
+ <para>
+ 成功時にtrue、失敗した場合にfalseを返します。
+ </para>
+ <example>
+ <title>複数の配列をソートする</title>
+ <programlisting role="php">
+$ar1 = array("10", 100, 100, "a");
+$ar2 = array(1, 3, "2", 1);
+array_multisort($ar1, $ar2);
+ </programlisting>
+ <para>
+ この例では、ソートの後で、最初の配列は、10,"a", 100, 100となりま
+ す。2番目の配列は、1, 1, 2, "3"を有します。最初の配列(100および
+ 100)の同じエントリに対応している2番目の配列のエントリは同時にソー
+ トされます。
+ </para>
+ </example>
+
+ <example>
+ <title>多次元の配列をソートする</title>
+ <programlisting role="php">
+$ar = array(array("10", 100, 100, "a"), array(1, 3, "2", 1));
+array_multisort($ar[0], SORT_ASC, SORT_STRING, $ar[1], SORT_NUMERIC, SORT_DESC);
+ </programlisting>
+ <para>
+ この例では、ソートされた後、最初の配列は10,100, 100, "a" (文字列
+ として昇順にソートされています)を有しており、2番目の配列は、
+ 1, 3, "2", 1 (数値として降順にソートされています)となっています。
+ </para>
+ </example>
+ </refsect1>
+ </refentry>
+
   <refentry id="function.array-pad">
    <refnamediv>
     <refname>array_pad</refname>
@@ -350,6 +497,55 @@
    </refsect1>
   </refentry>
 
+ <refentry id="function.array-rand">
+ <refnamediv>
+ <refname>array_rand</refname>
+ <refpurpose>配列から一つ以上の要素をランダムに取得する</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>引数</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>mixed <function>array_rand</function></funcdef>
+ <paramdef>array <parameter>input</parameter></paramdef>
+ <paramdef>int
+ <parameter><optional>num_req</optional></parameter>
+ </paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ <function>array_rand</function>は、配列から一つ以上のランダムなエ
+ ントリを取得しようとする場合に有用です。この関数は、配列
+ <parameter>input</parameter>およびオプションとして
+ <parameter>num_req</parameter>を引数とします。この引数は、取得す
+ るエントリの数を指定します。指定されない場合は、デフォルトの1にな
+ ります。
+ </para>
+ <para>
+ エントリを一つだけ取得する場合、<function>array_rand</function>は
+ ランダムなエントリのキーを返します。その他の場合は、ランダムなエ
+ ントリのキーの配列を返します。これにより、ランダムなキーを取得し、
+ 配列から値を取得することが可能になります。
+ </para>
+ <para>
+ 乱数生成器を初期化するために<function>srand</function>をコールす
+ ることを忘れないで下さい。
+ </para>
+ <para>
+ <example>
+ <title><function>array_rand</function>の例</title>
+ <programlisting role="php">
+srand((double)microtime() * 10000000);
+$input = array("Neo", "Morpheus", "Trinity", "Cypher", "Tank");
+$rand_keys = array_rand($input, 2);
+print $input[$rand_keys[0]]."\n";
+print $input[$rand_keys[1]]."\n";
+ </programlisting>
+ </example>
+ </para>
+ </refsect1>
+ </refentry>
+
   <refentry id="function.array-reverse">
    <refnamediv>
     <refname>array_reverse</refname>
@@ -534,7 +730,7 @@
      ヒント: <parameter>replacement</parameter>も指定した場合に
      <parameter>offset</parameter>から配列の最後まで全てを削除するには、
      <parameter>length</parameter>を求めるために<literal>count($input)
- </literal>を用して下さい。
+ </literal>を佧Ԩして下さい。
     </para>
     <para>
      配列<parameter>replacement</parameter>が指定された場合、
@@ -768,7 +964,7 @@
     </funcsynopsis>
     <para>
      この関数は、連想配列において各配列のキーと要素との関係を維持しつ
- つソートを行います。この関数は、主に実際の要素の並び方が重要であ
+ つソーャ?行います。この関数は、主に実際の要素の並び方が重要であ
      る連想配列をソートするために使われます。
      <example>
       <title><function>arsort</function>の例</title>
@@ -789,7 +985,7 @@
 fruits[c] = apple
      </computeroutput>
      fruitsはアルファベットの逆順にソートされ、各要素とキーとの関係は
- 維持されます。
+ 維持されす。
     </para>
     <para>
      <function>asort</function>, <function>rsort</function>,
Index: phpdoc/ja/functions/classobj.xml
diff -u phpdoc/ja/functions/classobj.xml:1.2 phpdoc/ja/functions/classobj.xml:1.3
--- phpdoc/ja/functions/classobj.xml:1.2 Sat Jun 24 00:38:44 2000
+++ phpdoc/ja/functions/classobj.xml Wed Jul 12 15:13:29 2000
@@ -2,10 +2,217 @@
   <title>クラス/オブジェクト関数</title>
   <titleabbrev>クラス/オブジェクト</titleabbrev>
 
+ <partintro>
+ <sect1 id="classobj.partintro">
+ <title>導入</title>
+ <sect2 id="classobj.intro">
+ <title>概要</title>
+ <para>
+ 以下の関数により、クラスやインスタンスオブジェクトに関する情報を
+ 得ることが可能となります。オブジェクトが属するクラスの名前、その
+ メンバープロパティ、メソッドを取得可能です。
+ この関数を使用することにより、オブジェクトのクラスメンバーだけで
+ なく親クラス(すなわちそのオブジェクトクラスの派生元)の情報を得る
+ ことも可能です。
+ </para>
+ </sect2>
+ <sect2>
+ <title>使用例</title>
+ <para>
+ この例では、まず基底クラスおよびそのクラスの派生クラスを定義しま
+ す。基底クラスは食用か否か、色とかいった、一般的な野菜を記述しま
+ す。サブクラス<varname>spinach</varname>はその野菜の料理法と調理
+ 済であるかどうかの情報を追加します。
+ </para>
+ <para>
+ <example>
+ <title>classes.inc</title>
+ <programlisting role="php">
+&lt;?php
+
+// メンバープロパティとメソッドを有する基底クラス
+class Vegetable {
+
+ var $edible;
+ var $color;
+
+ function Vegetable( $edible, $color=&quot;green&quot; ) {
+ $this-&gt;edible = $edible;
+ $this-&gt;color = $color;
+ }
+
+ function is_edible() {
+ return $this-&gt;edible;
+ }
+
+ function what_color() {
+ return $this-&gt;color;
+ }
+
+} // クラスVegetableの終り
+
+
+// 基底クラスを拡張する
+class Spinach extends Vegetable {
+
+ var $cooked = false;
+
+ function Spinach() {
+ $this-&gt;Vegetable( true, &quot;green&quot; );
+ }
+
+ function cook_it() {
+ $this-&gt;cooked = true;
+ }
+
+ function is_cooked() {
+ return $this-&gt;cooked;
+ }
+
+} // クラスSpinachの終り
+
+?&gt;
+ </programlisting>
+ </example>
+ </para>
+ <para>
+ 続いて、これらのクラスから二つのオブジェクトのインスタンスを作成し、
+ 親クラスを含む情報を出力します。
+ また、いくつかのユーティリティ関数を定義します。これらは主に変数
+ を格好良く表示するためのものです。
+ </para>
+ <para>
+ <example>
+ <title>test_script.php</title>
+ <programlisting role="php">
+&lt;pre&gt;
+&lt;?php
+
+include &quot;classes.inc&quot;;
+
+// ユーティリティ関数
+
+function print_vars($obj) {
+ $arr = get_object_vars($obj);
+ while (list($prop, $val) = each($arr))
+ echo &quot;\t$prop = $val\n&quot;;
+}
+
+function print_methods($obj) {
+ $arr = get_class_methods(get_class($obj));
+ foreach ($arr as $method)
+ echo &quot;\tfunction $method()\n&quot;;
+}
+
+function class_parentage($obj, $class) {
+ global $$obj;
+ if (is_subclass_of($$obj, $class)) {
+ echo &quot;Object $obj belongs to class &quot;.get_class($$obj);
+ echo &quot; a subclass of $class\n&quot;;
+ } else {
+ echo &quot;Object $obj does not belong to a subclass of $class\n&quot;;
+ }
+}
+
+// 二つのオブジェクトのインスタンスを作成
+
+$veggie = new Vegetable(true,&quot;blue&quot;);
+$leafy = new Spinach();
+
+// オブジェクトに関する情報を出力
+echo &quot;veggie: CLASS &quot;.get_class($veggie).&quot;\n&quot;;
+echo &quot;leafy: CLASS &quot;.get_class($leafy);
+echo &quot;, PARENT &quot;.get_parent_class($leafy).&quot;\n&quot;;
+
+// veggieのプロパティを表示
+echo &quot;\nveggie: Properties\n&quot;;
+print_vars($veggie);
+
+// そしてleafyのメソッドを表示
+echo &quot;\nleafy: Methods\n&quot;;
+print_methods($leafy);
+
+echo &quot;\nParentage:\n&quot;;
+class_parentage(&quot;leafy&quot;, &quot;Spinach&quot;);
+class_parentage(&quot;leafy&quot;, &quot;Vegetable&quot;);
+?&gt;
+&lt;/pre&gt;
+ </programlisting>
+ </example>
+ </para>
+ <para>
+ 注意すべき大事な点ですが、上記の例ではオブジェクト
+ <varname>$leafy</varname>は
+ <varname>Vegetable</varname>のサブクラスであるクラス
+ <varname>Spinach</varname>のインスタンスであり、
+ このスクリプトの最後の部分は以下のような出力となります。
+ </para>
+ <para>
+ <informalexample>
+ <programlisting>
+ [...]
+Parentage:
+Object leafy does not belong to a subclass of Spinach
+Object leafy belongs to class spinach a subclass of Vegetable
+ </programlisting>
+ </informalexample>
+ </para>
+ </sect2>
+ </sect1>
+ </partintro>
+
+ <refentry id="function.get-class">
+ <refnamediv>
+ <refname>get_class</refname>
+ <refpurpose>オブジェクトのクラス名を返す</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>説明</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>string <function>get_class</function></funcdef>
+ <paramdef>object <parameter>obj</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ このクラスはオブジェクト<parameter>obj</parameter>がインスタンス
+ であるクラスの名前を返します。
+ </para>
+ <simpara>
+ <function>get_parent_class</function>、
+ <function>is_subclass_of</function>も参照下さい。
+ </simpara>
+ </refsect1>
+ </refentry>
+
+ <refentry id="function.get-parent-class">
+ <refnamediv>
+ <refname>get_parent_class</refname>
+ <refpurpose>オブジェクトの親クラスの名前を返す</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Description</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>string <function>get_parent_class</function></funcdef>
+ <paramdef>object <parameter>obj</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ この関数は、<parameter>obj</parameter>がインスタンスであるクラス
+ の親クラスの名前を返します。
+ </para>
+ <simpara>
+ <function>get_class</function>、
+ <function>is_subclass_of</function>も参照下さい。
+ </simpara>
+ </refsect1>
+ </refentry>
+
   <refentry id="function.get-class-methods">
    <refnamediv>
     <refname>get_class_methods</refname>
- <refpurpose>クラスメソッドの名前を配列として返す</refpurpose>
+ <refpurpose>クラスメソッドの名前を連想配列として返す</refpurpose>
    </refnamediv>
    <refsect1>
     <title>説明</title>
@@ -17,8 +224,12 @@
     </funcsynopsis>
     <para>
      この関数は、指定したクラス<parameter>class_name</parameter>に
- ついてメソッドの名前を配列として返します。
+ ついてメソッドの名前を連想配列として返します。
     </para>
+ <simpara>
+ <function>get_class_vars</function>、
+ <function>get_object_vars</function>も参照下さい。
+ </simpara>
    </refsect1>
   </refentry>
 
@@ -40,6 +251,10 @@
     <para>
      この関数は、クラスのデフォルトプロパティを配列として返します。
     </para>
+ <simpara>
+ <function>get_class_methods</function>、
+ <function>get_object_vars</function>も参照下さい。
+ </simpara>
    </refsect1>
   </refentry>
 
@@ -52,7 +267,7 @@
     <title>説明</title>
     <funcsynopsis>
      <funcprototype>
- <funcdef>array <function>get_class_vars</function></funcdef>
+ <funcdef>array <function>get_object_vars</function></funcdef>
       <paramdef>object <parameter>obj</parameter></paramdef>
      </funcprototype>
     </funcsynopsis>
@@ -60,6 +275,60 @@
      この関数は、指定したオブジェクト<parameter>obj</parameter>の
      オブジェクトプロパティを配列として返します。
     </para>
+ <simpara>
+ <function>get_class_methods</function>、
+ <function>get_class_vars</function>も参照下さい。
+ </simpara>
+ </refsect1>
+ </refentry>
+
+
+ <refentry id="function.is-subclass-of">
+ <refnamediv>
+ <refname>is_subclass_of</refname>
+ <refpurpose>
+ あるオブジェクトが指定したクラスのサブクラスに属するかどうかを調
+ べる
+ </refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>説明</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>bool <function>is_subclass_of</function></funcdef>
+ <paramdef>object <parameter>obj</parameter></paramdef>
+ <paramdef>string <parameter>superclass</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ この関数は、オブジェクト<parameter>obj</parameter>が
+ <parameter>superclass</parameter>のサブクラスであるクラスに属する
+ 場合にtrue、その他の場合にfalseを返します。
+ </para>
+ <simpara>
+ <function>get_class</function>,
+ <function>get_parent_class</function>も参照下さい。
+ </simpara>
+ </refsect1>
+ </refentry>
+
+ <refentry id="function.class-exists">
+ <refnamediv>
+ <refname>class_exists</refname>
+ <refpurpose>クラスが定義済か確認する</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>説明</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>bool <function>class_exists</function></funcdef>
+ <paramdef>string <parameter>class_name</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ この関数は、<parameter>class_name</parameter>で指定したクラスが定
+ 義されている場合にtrue、その他の場合にfalseを返します。
+ </para>
    </refsect1>
   </refentry>
 
@@ -82,6 +351,35 @@
      指定した<parameter>object</parameter>において定義されている
      場合にtrue、そうでない場合にfalseを返します。
     </para>
+ </refsect1>
+ </refentry>
+
+ <refentry id="function.get-declared-classes">
+ <refnamediv>
+ <refname>get_declared_classes</refname>
+ <refpurpose>定義済のクラスの名前を配列として返す</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>説明</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>array <function>get_declared_classes</function></funcdef>
+ <paramdef>void</paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ この関数は、カレントのスクリプトで宣言されたクラスの名前の配列を
+ 返します。
+ </para>
+ <note>
+ <para>
+ PHP 4.0.1pl2では、この他に次の3つのクラスが配列の先頭に返されま
+ す。: <varname>stdClass</varname> (Zend/zend.cで定義)、
+ <varname>OverloadedTestClass</varname>
+ (ext/standard/basic_functions.cで定義)、<varname>Directory</varname>
+ (ext/standard/dir.cで定義)
+ </para>
+ </note>
    </refsect1>
   </refentry>
 
Index: phpdoc/ja/functions/datetime.xml
diff -u phpdoc/ja/functions/datetime.xml:1.9 phpdoc/ja/functions/datetime.xml:1.10
--- phpdoc/ja/functions/datetime.xml:1.9 Sat Jun 24 00:38:44 2000
+++ phpdoc/ja/functions/datetime.xml Wed Jul 12 15:13:29 2000
@@ -167,6 +167,11 @@
       </listitem>
       <listitem>
        <simpara>
+ T - このマシーンのタイムゾーンの設定。例えば、"MDT"
+ </simpara>
+ </listitem>
+ <listitem>
+ <simpara>
         U - Unix 時(1970年1月1日)からの秒数
        </simpara>
       </listitem>
@@ -668,7 +673,7 @@
      フォーマット文字列に基づき文字列をフォーマットして返します。
      月および曜日の名前およびその他の言語依存の文字列は、
      <function>setlocale</function> でセットされた現在のロケール
- に関係します。
+ に関係します
     </para>
     <para>
      次の変換指定子は、フォーマット文字列として認識されます。
Index: phpdoc/ja/functions/exec.xml
diff -u phpdoc/ja/functions/exec.xml:1.3 phpdoc/ja/functions/exec.xml:1.4
--- phpdoc/ja/functions/exec.xml:1.3 Sat Jun 24 00:38:44 2000
+++ phpdoc/ja/functions/exec.xml Wed Jul 12 15:13:29 2000
@@ -58,30 +58,40 @@
     </funcsynopsis>
 
     <para>
- <function>exec</function> は指定された <parameter>command</parameter>を実行しますが、
- 一切の出力はありません。ただ単に、コマンド結果の最後の行を返すだけ
- です。コマンドを実行し、一切干渉を受けずに直接コマンドから全てのデータを
- 受けとる必要があるならば、<function>PassThru</function> 関数を
- 使ってください。</para>
- <para>
- 引数<parameter>array</parameter>が存在する場合、指定した配列は、
- コマンドからの出力の各行で埋められます。配列に既に何らかの要素が
- 含まれる場合は、<function>exec</function>は配列の最後に追加される
- ことに注意してください。関数が要素を追加することを望まないのなら、
- それが <function>exec</function> に渡される前に、配列の
- <function>unset</function>を呼び出してください。
- 引数<parameter>return_var</parameter>が、引数
- <parameter>array</parameter>と共に存在する場合、実行したコマンドの
- ステータスがこの変数に書かれます。</para>
- <para>
- ユーザ入力によるデータを、この関数に渡すことを許可したいのであれば、
- ユーザがシステムをだまして勝手なコマンドを実行できないように、
- <function>EscapeShellCmd</function>を使うべきです。</para>
- <para>
- <function>system</function>,<function>PassThru</function>,
- <function>popen</function>,<function>EscapeShellCmd</function>,
- <link linkend="language.operators.execution">backtick 演算子</link>
- も参照ください。</para>
+ <function>exec</function>は指定された
+ <parameter>command</parameter>を実行しますが、一切の出力はありませ
+ ん。ただ単に、コマンド結果の最後の行を返すだけです。コマンドを実行
+ し、一切干渉を受けずに直接コマンドから全てのデータを受けとる必要が
+ あるならば、<function>PassThru</function> 関数を使ってください。
+ </para>
+ <para>
+ 引数<parameter>array</parameter>が存在する場合、指定した配列は、
+ コマンドからの出力の各行で埋められます。配列に既に何らかの要素が
+ 含まれる場合は、<function>exec</function>は配列の最後に追加される
+ ことに注意してください。関数が要素を追加することを望まないのなら、
+ それが <function>exec</function> に渡される前に、配列の
+ <function>unset</function>を呼び出してください。
+ 引数<parameter>return_var</parameter>が、引数
+ <parameter>array</parameter>と共に存在する場合、実行したコマンドの
+ ステータスがこの変数に書かれます。
+ </para>
+ <para>
+ ユーザ入力によるデータを、この関数に渡すことを許可したいのであれば、
+ ユーザがシステムをだまして勝手なコマンドを実行できないように、
+ <function>escapeshellcmd</function>を使うべきです。
+ </para>
+ <para>
+ この関数を使用してプログラム実行を開始し、バックグラウンドで実行
+ したままにしたい場合には、プログラムの出力をファイルまたは他の出
+ 力ストリームにリダイレクトする必要があることにも注意して下さい。
+ さもないと、PHPはそのプログラムの実行が終了するまでハングします。
+ </para>
+ <para>
+ <function>system</function>,<function>passthru</function>,
+ <function>popen</function>,<function>escapeshellcmd</function>,
+ <link linkend="language.operators.execution">backtick 演算子</link>
+ も参照ください。
+ </para>
    </refsect1>
   </refentry>
 
@@ -96,28 +106,38 @@
      <funcprototype>
       <funcdef>void <function>passthru</function></funcdef>
       <paramdef>string <parameter>command</parameter></paramdef>
- <paramdef>int <parameter><optional>return_var</optional></parameter></paramdef>
+ <paramdef>int
+ <parameter><optional>return_var</optional></parameter>
+ </paramdef>
      </funcprototype>
     </funcsynopsis>
     <para>
- PassThru()関数は<function>Exec</function>関数と同様、
+ <function>passthru</function>関数は<function>exec</function>関数と同様、
      <parameter>command</parameter>を実行します。
      引数 <parameter>return_var</parameter> を指定した場合、
      Unix command のステータスで置換されます。
      この関数は Unix command からの出力がバイナリデータであり、
- ブラウザーへ直接返す必要がある場合、<function>Exec</function>
- もしくは<function>System</function>の代わりに使用する必要があります。
+ ブラウザーへ直接返す必要がある場合、<function>exec</function>
+ もしくは<function>system</function>の代わりに使用する必要があります。
      よく使うのは、直接画像ストリームを出力することができる pbmplus
      ユーティリティの様なものを実行する場合です。content-type を
      <emphasis>image/gif</emphasis>に設定して、gifを出力するpbmplus
      プログラムを呼び出すことにより、直接画像を出力する PHP スクリプトを作成
- することができます。</para>
+ することができます。
+ </para>
     <para>
- <function>exec</function>,
- <function>system</function>, <function>popen</function>,
- <function>EscapeShellCmd</function>,
- <link linkend="language.operators.execution">backtick 演算子</link>
- も参照下さい。</para>
+ この関数を使用してプログラム実行を開始し、バックグラウンドで実行
+ したままにしたい場合には、プログラムの出力をファイルまたは他の出
+ 力ストリームにリダイレクトする必要があることにも注意して下さい。
+ さもないと、PHPはそのプログラムの実行が終了するまでハングします。
+ </para>
+ <para>
+ <function>exec</function>,
+ <function>system</function>, <function>popen</function>,
+ <function>escapeshellcmd</function>,
+ <link linkend="language.operators.execution">backtick 演算子</link>
+ も参照下さい。
+ </para>
    </refsect1>
   </refentry>
 
@@ -132,34 +152,47 @@
      <funcprototype>
       <funcdef>string <function>system</function></funcdef>
       <paramdef>string <parameter>command</parameter></paramdef>
- <paramdef>int <parameter><optional>return_var</optional></parameter></paramdef>
+ <paramdef>int
+ <parameter><optional>return_var</optional></parameter>
+ </paramdef>
      </funcprototype>
     </funcsynopsis>
     <para>
- <function>System</function>は、与えられた
- <parameter>command</parameter>を実行し、結果を出力する
- C言語のsystem関数に似ています。
- 2番目の引数として変数が指定された場合、実行したコマンドの
- ステータスコードが、この変数に書き込まれます。</para>
+ <function>System</function>は、指定した
+ <parameter>command</parameter>を実行し、結果を出力するC言語の
+ system関数に似ています。2番目の引数として変数が指定された場合、実
+ 行したコマンドのステータスコードが、この変数に書き込まれます。
+ </para>
     <para>
- ユーザが入力したデータをこの関数に渡そうとする場合、
+ ユーザが入力したデータをこの関数に渡そうとする場合、
     <function>EscapeShellCmd</function>を使用して、ユーザが
- システムをだまして、勝手なコマンドを実行することのないように
- するべきです。</para>
+ システムをだまして、勝手なコマンドを実行することのないように
+ するべきです。
+ </para>
     <para>
- PHP をサーバモジュールとして実行している場合、
- <function>System</function> 呼び出しにより、各行を出力した後、
- webサーバの出力バッファが自動的にクリアされます。</para>
+ この関数を使用してプログラム実行を開始し、バックグラウンドで実行
+ したままにしたい場合には、プログラムの出力をファイルまたは他の出
+ 力ストリームにリダイレクトする必要があることにも注意して下さい。
+ さもないと、PHPはそのプログラムの実行が終了するまでハングします。
+ </para>
+ <para>
+ PHPをサーバモジュールとして実行している場合、
+ <function>system</function>のコールにより、各行を出力した後、
+ webサーバの出力バッファが自動的にクリアされます。
+ </para>
     <para>
- 成功時にコマンド出力の最後の行が返され、失敗時に false が返されます。
+ 成功時にコマンド出力の最後の行が返され、失敗時にfalseが返されます。
     </para>
     <para>
- コマンドを実行し、何の加工もせずに全てのデータをコマンドから直接
- 返す必要がある場合、<function>PassThru</function>関数をお使いください。</para>
+ コマンドを実行し、何の加工もせずに全てのデータをコマンドから直接
+ 返す必要がある場合、<function>PassThru</function>関数をお使いくだ
+ さい。
+ </para>
     <para>
- <function>exec</function>, <function>PassThru</function>, <function>popen</function>,
- <function>EscapeShellCmd</function>, <link
- linkend="language.operators.execution">backtick 演算子</link>を参照下さい。
+ <function>exec</function>, <function>PassThru</function>,
+ <function>popen</function>,<function>EscapeShellCmd</function>,
+ <link linkend="language.operators.execution">backtick 演算子
+ </link>を参照下さい。
    </para>
    </refsect1>
   </refentry>
Index: phpdoc/ja/functions/filesystem.xml
diff -u phpdoc/ja/functions/filesystem.xml:1.9 phpdoc/ja/functions/filesystem.xml:1.10
--- phpdoc/ja/functions/filesystem.xml:1.9 Sat Jun 24 00:38:44 2000
+++ phpdoc/ja/functions/filesystem.xml Wed Jul 12 15:13:29 2000
@@ -970,7 +970,7 @@
        <simpara>
         ロック中に<function>flock</function>でブロックを行いたくない場合は、
         <parameter>operation</parameter>にLOCK_NB
- (PHP 4.0.1より前の場合は4に設定します)を加えます。
+ (PHP 4.0.1より前場合は4に設定します)を加えます。
        </simpara>
       </listitem>
      </itemizedlist>
@@ -1386,7 +1386,7 @@
      事象により書き込みは中止されます。
     </simpara>
     <simpara>
- <parameter>length</parameter>パラメータが指定されている場合、
+ <parameter>length</parameter>パラメータが指定されてる場合、
     <link linkend="ini.magic-quotes-runtime">magic_quotes_runtime</link>
     構成オプションは無視され、<parameter>string</parameter>からの
     スラッシュ文字の取り除きは行われないことに注意して下さい。
@@ -2062,6 +2062,36 @@
    </refsect1>
   </refentry>
   
+ <refentry id="function.realpath">
+ <refnamediv>
+ <refname>realpath</refname>
+ <refpurpose>絶対パス名を返す</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>説明</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>string <function>realpath</function></funcdef>
+ <paramdef>string <parameter>path</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ <function>realpath</function>は、シンボリックリンクを全て展開し、
+ 入力<parameter>path</parameter>の'/./'、'/../'、'/'が指すものを調
+ べます。返されるパスはシンボリックリンクや'/./'、'/../'要素を含み
+ ません。
+ </para>
+ <para>
+ <example>
+ <title><function>realpath</function>の例</title>
+ <programlisting role="php">
+$real_path = realpath("../../index.php");
+ </programlisting>
+ </example>
+ </para>
+ </refsect1>
+ </refentry>
+
   <refentry id="function.symlink">
    <refnamediv>
     <refname>symlink</refname>
Index: phpdoc/ja/functions/info.xml
diff -u phpdoc/ja/functions/info.xml:1.6 phpdoc/ja/functions/info.xml:1.7
--- phpdoc/ja/functions/info.xml:1.6 Sun Jul 2 03:54:04 2000
+++ phpdoc/ja/functions/info.xml Wed Jul 12 15:13:29 2000
@@ -618,74 +618,277 @@
 
    </refsect1>
   </refentry>
-
- <refentry id="function.set-magic-quotes-runtime">
- <refnamediv>
- <refname>set_magic_quotes_runtime</refname>
- <refpurpose>magic_quotes_runtime の現在アクティブな設定を設定します。
-</refpurpose>
- </refnamediv>
- <refsect1>
- <title>説明</title>
- <funcsynopsis>
+
+ <refentry id="function.set-magic-quotes-runtime">
+ <refnamediv>
+ <refname>set_magic_quotes_runtime</refname>
+ <refpurpose>magic_quotes_runtime の現在アクティブな設定を設定します。
+ </refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>説明</title>
+ <funcsynopsis>
      <funcprototype>
- <funcdef>long <function>set_magic_quotes_runtime</function></funcdef>
- <paramdef>int <parameter>new_setting</parameter></paramdef>
+ <funcdef>long <function>set_magic_quotes_runtime</function></funcdef>
+ <paramdef>int <parameter>new_setting</parameter></paramdef>
      </funcprototype>
      </funcsynopsis>
-
- <simpara>
- <link linkend="ini.magic-quotes-runtime">magic_quotes_runtime</link>
- の現在アクティブな設定をセットします。
- (オフの場合 0、オンの場合 1)</simpara>
-
- <simpara>
- <function>get_magic_quotes_gpc</function>,
- <function>get_magic_quotes_runtime</function> も参照下さい。</simpara>
- </refsect1>
- </refentry>
-
- <refentry id="function.set-time-limit">
- <refnamediv>
- <refname>set_time_limit</refname>
- <refpurpose>実行時間の最大値を制限します</refpurpose>
- </refnamediv>
- <refsect1>
- <title>説明</title>
- <funcsynopsis>
+ <simpara>
+ <link linkend="ini.magic-quotes-runtime">magic_quotes_runtime</link>
+ の現在アクティブな設定をセットします。(オフの場合 0、オンの場合 1)
+ </simpara>
+ <simpara>
+ <function>get_magic_quotes_gpc</function>,
+ <function>get_magic_quotes_runtime</function> も参照下さい。
+ </simpara>
+ </refsect1>
+ </refentry>
+
+ <refentry id="function.set-time-limit">
+ <refnamediv>
+ <refname>set_time_limit</refname>
+ <refpurpose>実行時間の最大値を制限します</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>説明</title>
+ <funcsynopsis>
      <funcprototype>
- <funcdef>void <function>set_time_limit</function></funcdef>
- <paramdef>int <parameter>seconds</parameter></paramdef>
+ <funcdef>void <function>set_time_limit</function></funcdef>
+ <paramdef>int <parameter>seconds</parameter></paramdef>
      </funcprototype>
- </funcsynopsis>
- <simpara>
+ </funcsynopsis>
+ <simpara>
      スクリプトが実行可能な秒数を設定します。
      この制限にかかるとスクリプトは致命的エラーを返します。
      デフォルトの制限値は 30 秒です。
      なお、<link linkend="configuration.file">設定ファイル</link>で
- max_execution_time の値が定義されている場合にはそれを用います。
- secondsにゼロをセットした場合、時間制限は行われません。</simpara>
-
- <simpara>
+ max_execution_time の値が定義されている場合にはそれを用います。
+ secondsにゼロをセットした場合、時間制限は行われません。
+ </simpara>
+ <simpara>
      <function>set_time_limit</function> がコールされた場合、
      タイムアウトカウンターをゼロから再スタートします。
-
      言いかえると、タイムアウトがデフォルトの 30 秒で
      スクリプト実行までに 25 秒かかる場合に、
- set_time_limit( 20 ) を実行すると、スクリプトは、
+ set_time_limit( 20 ) を実行すると、スクリプトは、
      タイムアウトまでに全体で 45 s の間実行されます。
- </simpara>
+ </simpara>
+ <simpara>
+ <function>set_time_limit</function> は、PHPがセーフモードで実行さ
+ れている場合には実効がないことに注意して下さい。セーフモードをオ
+ フにするか、<link linkend="configuration.file">設定ファイル
+ </link>の時間制限を変更する以外に対策はありません。
+ </simpara>
+ </refsect1>
+ </refentry>
+
+ <refentry id="function.get-loaded-extensions">
+ <refnamediv>
+ <refname>get_loaded_extensions</refname>
+ <refpurpose>
+ コンパイル/ロードされている全てのモジュールの名前を配列として返す
+ </refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>説明</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>array <function>get_loaded_extensions</function></funcdef>
+ <paramdef>void </paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ この関数は、PHPインタプリタにコンパイル、ロードされている全てのモ
+ ジュールの名前を返します。
+ </para>
+ <para>
+ 例えば以下のようになります。
+ <informalexample>
+ <programlisting role="php">
+print_r (get_loadedextensions());
+ </programlisting>
+ </informalexample>
+ この例の出力は以下のようになります。
+ <informalexample>
+ <programlisting>
+Array
+(
+ [0] =&gt; xml
+ [1] =&gt; wddx
+ [2] =&gt; standard
+ [3] =&gt; session
+ [4] =&gt; posix
+ [5] =&gt; pgsql
+ [6] =&gt; pcre
+ [7] =&gt; gd
+ [8] =&gt; ftp
+ [9] =&gt; db
+ [10] =&gt; Calendar
+ [11] =&gt; bcmath
+)
+ </programlisting>
+ </informalexample>
+ </para>
+ <para>
+ <function>get_extension_functions</function>も参照下さい。
+ </para>
+ </refsect1>
+ </refentry>
+
+ <refentry id="function.get-extension-functions">
+ <refnamediv>
+ <refname>get_extension_functions</refname>
+ <refpurpose>
+ あるモジュールの関数名を配列として返す
+ </refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>説明</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>array <function>get_extension_functions</function></funcdef>
+ <paramdef>string <parameter>module_name</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ この関数は、<parameter>module_name</parameter>で示したモジュール
+ で定義された全ての関数の名前を返します。
+ </para>
+ <para>
+ 例えば以下のようになります。
+ <informalexample>
+ <programlisting role="php">
+print_r (get_extension_funcs(&quot;xml&quot;));
+print_r (get_extension_funcs(&quot;gd&quot;));
+ </programlisting>
+ </informalexample>
+ この例は、モジュール<varname>xml</varname>および
+ <varname>gd</varname>の関数のリストをそれぞれ表示します。
+ </para>
+ <para>
+ <function>get_loaded_extensions</function>も参照下さい。
+ </para>
+ </refsect1>
+ </refentry>
+
+ <refentry id="function.get-required-files">
+ <refnamediv>
+ <refname>get_required_files</refname>
+ <refpurpose>
+ あるスクリプトでrequire_once()でロードされたファイルの名前を配列
+ として返す
+ </refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>説明</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>array <function>get_required_files</function></funcdef>
+ <paramdef>void </paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ この関数は、<function>require_once</function>によりスクリプトにロー
+ ドされた全てのファイルの名前を連想配列として返します。
+ <function>require_once</function>で使用した際と同様に拡張子
+ &quot;.php&quot;を除いたファイル名が配列の添字となります。
+ </para>
+ <para>
+ <example>
+ <title>読み込まれたファイルを出力する</title>
+ <programlisting role="php">
+&lt;?php
+
+require_once (&quot;local.php&quot;);
+require_once (&quot;../inc/global.php&quot;);
+
+for ($i=1; $i&lt;5; $i++)
+ include &quot;util&quot;.$i.&quot;php&quot;;
+
+echo &quot;Required_once files\n&quot;;
+print_r (get_required_files());
 
- <simpara>
- <function>set_time_limit</function> は、PHPがセーフモードで実行されている場合には
- 実効がないことに注意して下さい。セーフモードをオフにするか、
- <link linkend="configuration.file">設定ファイル</link> の時間制限を変更する
- 以外に対策はありません。
- </simpara>
-
- </refsect1>
- </refentry>
-
+echo &quot;Included_once files\n&quot;;
+print_r (get_included_files());
+ </programlisting>
+ </example>
+ 上記の例の出力は次のようになります。
+ <informalexample>
+ <programlisting>
+Required_once files
+Array
+(
+ [local] =&gt; local.php
+ [../inc/global] =&gt; /full/path/to/inc/global.php
+)
+
+Included_once files
+Array
+(
+ [util1] =&gt; util1.php
+ [util2] =&gt; util2.php
+ [util3] =&gt; util3.php
+ [util4] =&gt; util4.php
+)
+ </programlisting>
+ </informalexample>
+ </para>
+ <para>
+ <note>
+ <para>
+ PHP 4.0.1pl2においてこの関数は、
+ <varname>required_once</varname>で読み込まれるファイルの名前が
+ 拡張子&quot;.php&quot;で終ることを仮定しており、他の拡張子では
+ 動作しません。
+ </para>
+ </note>
+ </para>
+ <para>
+ <function>require_once</function>、
+ <function>include_once</function>、
+ <function>get_included_files</function>も参照下さい。
+ </para>
+ </refsect1>
+ </refentry>
+
+ <refentry id="function.get-included-files">
+ <refnamediv>
+ <refname>get_included_files</refname>
+ <refpurpose>
+ スクリプトにinclude_once()されたファイルの名前を配列として返す
+ </refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>説明</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>array <function>get_included_files</function></funcdef>
+ <paramdef>void </paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ この関数は、<function>include_once</function>によりスクリプトにロー
+ ドされた全てのファイルの名前を連想配列として返します。
+ <function>include_once</function>で使用した際と同様に拡張子
+ &quot;.php&quot;を除いたファイル名が配列の添字となります。
+ </para>
+ <para>
+ <note>
+ <para>
+ PHP 4.0.1pl2においてこの関数は、
+ <varname>include_once</varname>で読み込まれるファイルの名前が
+ 拡張子&quot;.php&quot;で終ることを仮定しており、他の拡張子では
+ 動作しません。
+ </para>
+ </note>
+ </para>
+ <para>
+ <function>require_once</function>、
+ <function>include_once</function>、
+ <function>get_required_files</function>も参照下さい。
+ </para>
+ </refsect1>
+ </refentry>
 
 </reference>
 
Index: phpdoc/ja/functions/misc.xml
diff -u phpdoc/ja/functions/misc.xml:1.7 phpdoc/ja/functions/misc.xml:1.8
--- phpdoc/ja/functions/misc.xml:1.7 Mon Jul 10 16:08:38 2000
+++ phpdoc/ja/functions/misc.xml Wed Jul 12 15:13:29 2000
@@ -1088,7 +1088,7 @@
    </refsect1>
   </refentry>
 
- <refentry id="function.highlight_string">
+ <refentry id="function.highlight-string">
    <refnamediv>
     <refname>highlight_string</refname>
     <refpurpose>文字列の構文ハイライト表示</refpurpose>
@@ -1107,13 +1107,13 @@
      ライト表示を出力します。
     </simpara>
     <simpara>
- <function>higlight_file</function>,
+ <function>highlight_file</function>,
      <function>show_source</function>も参照下さい。
     </simpara>
    </refsect1>
   </refentry>
 
- <refentry id="function.highlight_file">
+ <refentry id="function.highlight-file">
    <refnamediv>
     <refname>highlight_file</refname>
     <refpurpose>ファイルの構文ハイライト表示</refpurpose>
@@ -1202,7 +1202,7 @@
    </refsect1>
   </refentry>
 
- <refentry id="function.show_source">
+ <refentry id="function.show-source">
    <refnamediv>
     <refname>show_source</refname>
     <refpurpose>ファイルの構文ハイライト表示</refpurpose>
Index: phpdoc/ja/functions/strings.xml
diff -u phpdoc/ja/functions/strings.xml:1.9 phpdoc/ja/functions/strings.xml:1.10
--- phpdoc/ja/functions/strings.xml:1.9 Mon Jul 10 16:08:38 2000
+++ phpdoc/ja/functions/strings.xml Wed Jul 12 15:13:29 2000
@@ -1886,7 +1886,7 @@
      この関数は、文字列<parameter>input</parameter>の左、右または両側
      を指定した長さで埋めます。オプションの引数
      <parameter>pad_string</parameter>が指定されていない場合、
- <parameter>input</parameter>は空白で埋められ、そのの場合は
+ <parameter>input</parameter>は空白で埋められ、そのの場合は
      <parameter>pad_string</parameter>からの文字で制限まで埋められます。
     </para>
     <para>
@@ -2344,7 +2344,7 @@
     <para>
      この関数は、<parameter>haystack</parameter>の中の
      <parameter>needle</parameter>を全て<parameter>str</parameter>に置換します。
- 技巧的な置換ルールを必要としない場合、<function>ereg_replace</function>
+ 技巧的な置ルールを必要としない場合、<function>ereg_replace</function>
      の替わりにこの関数を常用するべきです。
     </para>
     <para>
@@ -2508,6 +2508,36 @@
    </refsect1>
   </refentry>
  
+ <refentry id="function.substr-count">
+ <refnamediv>
+ <refname>substr_count</refname>
+ <refpurpose>副文字列の出現関数を数える</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>説明</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>int <function>substr_count</function></funcdef>
+ <paramdef>string <parameter>haystrack</parameter></paramdef>
+ <paramdef>string <parameter>needle</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ <function>substr_count</function>は、文字列
+ <parameter>haystack</parameter>の中での副文字列
+ <parameter>needle</parameter>の出現回数を返します。
+ </para>
+ <para>
+ <example>
+ <title><function>substr_count</function>の例</title>
+ <programlisting>
+print substr_count("This is a test", "is"); // 2を出力する
+ </programlisting>
+ </example>
+ </para>
+ </refsect1>
+ </refentry>
+
   <refentry id="function.substr-replace">
    <refnamediv>
     <refname>substr_replace</refname>
Index: phpdoc/ja/functions/var.xml
diff -u phpdoc/ja/functions/var.xml:1.13 phpdoc/ja/functions/var.xml:1.14
--- phpdoc/ja/functions/var.xml:1.13 Mon Jul 3 15:50:09 2000
+++ phpdoc/ja/functions/var.xml Wed Jul 12 15:13:29 2000
@@ -43,6 +43,72 @@
    </refsect1>
   </refentry>
 
+ <refentry id="function.call-user-method">
+ <refnamediv>
+ <refname>call_user_method</refname>
+ <refpurpose>
+ 指定したオブジェクトのユーザーメソッドをコールする
+ </refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>説明</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>mixed
+ <function>call_user_method</function>
+ </funcdef>
+ <paramdef>string
+ <parameter>method_name</parameter>
+ </paramdef>
+ <paramdef>object
+ <parameter>obj</parameter>
+ </paramdef>
+ <paramdef>mixed
+ <parameter><optional>parameter</optional></parameter>
+ </paramdef>
+ <paramdef>mixed
+ <parameter><optional>...</optional></parameter>
+ </paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ ユーザーが定義したオブジェクト<parameter>obj</parameter>の
+ <parameter>method_name</parameter>で指すメソッドをコールします。
+ 以下の使用例ではクラスを定義し、オブジェクトのインスタンスを作成
+ し、<function>call_user_method</function>によりそのクラスの
+ <varname>print_info</varname>メソッドを間接的にコールします。
+ <informalexample>
+ <programlisting role="php">
+&lt;?php
+class Country {
+ var $NAME;
+ var $TLD;
+
+ function Country($name, $tld) {
+ $this-&gt;NAME = $name;
+ $this-&gt;TLD = $tld;
+ }
+
+ function print_info($prestr=&quot;&quot;) {
+ echo $prestr.&quot;Country: &quot;.$this-&gt;NAME.&quot;\n&quot;;
+ echo $prestr.&quot;Top Level Domain: &quot;.$this-&gt;TLD.&quot;\n&quot;;
+ }
+}
+
+$cntry = new Country(&quot;Peru&quot;,&quot;pe&quot;);
+
+echo &quot;* Calling the object method directly\n&quot;;
+$cntry-&gt;print_info();
+
+echo &quot;\n* Calling the same method indirectly\n&quot;;
+call_user_method (&quot;print_info&quot;, $cntry, &quot;\t&quot;);
+?&gt;
+ </programlisting>
+ </informalexample>
+ </para>
+ </refsect1>
+ </refentry>
+
   <refentry id="function.doubleval">
    <refnamediv>
     <refname>doubleval</refname>
Index: phpdoc/ja/language/control-structures.xml
diff -u phpdoc/ja/language/control-structures.xml:1.6 phpdoc/ja/language/control-structures.xml:1.7
--- phpdoc/ja/language/control-structures.xml:1.6 Mon Jul 10 16:08:38 2000
+++ phpdoc/ja/language/control-structures.xml Wed Jul 12 15:13:29 2000
@@ -847,7 +847,7 @@
    </simpara>
    <para>
     読み込み処理は<literal>include</literal>文を処理する度に行われます。
- このため、異なった複数のファイルを読み込むためにルプ構造の中で
+ このため、異なった複数のファイルを読み込むためにル×構造の中で
     <literal>include</literal>を使用することができます。
     <informalexample>
      <programlisting role="php">
@@ -1004,6 +1004,36 @@
    </simpara>
   </sect1>
 
+ <sect1 id="function.require-once">
+ <title><function>require_once</function></title>
+ <simpara>
+ <function>require_once</function>命令は、C言語のプリプロセッサ
+ <literal>#include</literal>の動作と同様にこの部分を指定したファイ
+ ルで置換します。
+ </simpara>
+ <para>
+ <function>require</function>、<function>include</function>、
+ <function>include_once</function>、
+ <function>get_required_files</function>、
+ <function>get_included_files</function>も参照下さい。
+ </para>
+ </sect1>
+
+ <sect1 id="function.include-once">
+ <title><function>include_once</function></title>
+ <simpara>
+ <function>include_once</function>命令は、C言語のプリプロセッサ
+ <literal>#include</literal>の動作と全く同様にこの部分を指定したファイ
+ ルで置換します。
+ </simpara>
+ <para>
+ <function>require</function>、<function>include</function>、
+ <function>require_once</function>、
+ <function>get_required_files</function>、
+ <function>get_included_files</function>も参照下さい。
+ </para>
+ </sect1>
+
  </chapter>
  
  <!-- Keep this comment at the end of the file