Modified: phpdoc/ja/trunk/language/control-structures/require.xml =================================================================== --- phpdoc/ja/trunk/language/control-structures/require.xml 2009-10-11 00:06:17 UTC (rev 289510) +++ phpdoc/ja/trunk/language/control-structures/require.xml 2009-10-11 00:14:30 UTC (rev 289511) @@ -1,6 +1,6 @@ - + <function>require</function> @@ -8,7 +8,7 @@ require は include とほぼ同じですが、失敗した場合に E_ERROR - レベルの致命的なエラーが発生するという点が異なります。 + レベルの致命的なエラーも発生するという点が異なります。 つまり、スクリプトの処理がそこで止まってしまうということです。一方 include の場合は、警告 (E_WARNING) を発するもののスクリプトの処理は続行します。 Modified: phpdoc/ja/trunk/language/references.xml =================================================================== --- phpdoc/ja/trunk/language/references.xml 2009-10-11 00:06:17 UTC (rev 289510) +++ phpdoc/ja/trunk/language/references.xml 2009-10-11 00:14:30 UTC (rev 289511) @@ -1,6 +1,6 @@ - + リファレンスの説明 @@ -26,41 +26,52 @@ リファレンスが行うことは何ですか? - PHP のリファレンスにより二つの変数が同じ内容を参照することが可能です。 - つまり、以下のようなものを実行した場合です。 - - + There are three basic operations performed using references: + assigning by + reference, passing + by reference, + and returning by + reference. This section will give an introduction to these + operations, with links to further reading. + + + Assign By Reference + + In the first of these, PHP references allow you to make two + variables refer to the same content. Meaning, when you do: + + ]]> - - - この場合、$a と $b は同じ内容を - 指します。 + + + この場合、$a と $b + は同じ内容を指します。 + + + ここで、$a と $b は完全に + 同じで、$a が $b を + 指しているわけではなく、その逆でもありません。$a と + $b は同じ場所を指しているのです。 + + + - ここで、$a と $b は完全に - 同じで、$a が $b を - 指しているわけではなく、その逆でもありません。$a と - $b は同じ場所を指しているのです。 + リファレンスを含む配列をコピーする際に、そのリファレンスが解消される + ことはありません。配列を関数に値渡しする場合も同様です。 - - - - リファレンスを含む配列をコピーする際に、そのリファレンスが解消される - ことはありません。配列を関数に値渡しする場合も同様です。 - - - - - 未定義の変数のリファレンスに対して代入したり - 渡したり返したりすると、そこで変数が作成されます。 - - 未定義の変数のリファレンスの使用 - + + + 未定義の変数のリファレンスに対して代入したり + 渡したり返したりすると、そこで変数が作成されます。 + + 未定義の変数のリファレンスの使用 + ]]> - - - - - - リファレンスを返す関数や new 演算子でも - 同じ構文が使用可能です（PHP 4.0.4 以降）。 - - + + + + + + リファレンスを返す関数や new 演算子でも + 同じ構文が使用可能です（PHP 4.0.4 以降）。 + + ]]> - - - PHP 5 以降、new - は自動的にリファレンスを返すようになりました。そのため、この場面で - =& を使用することは非推奨となり、 - E_STRICT レベルのメッセージが表示されるようになりました。 - + + + PHP 5 以降、new + は自動的にリファレンスを返すようになりました。そのため、この場面で + =& を使用することは非推奨となり、 + E_STRICT レベルのメッセージが表示されるようになりました。 + - & 演算子を使用しない場合は、オブジェクトのコピーが - 作成されます。クラスの内部で $this を使用した場合、 - それはクラスの現在のインスタンスに対する操作を表します。 - & のない代入はインスタンス（オブジェクト）のコピーを - 行い、$this はそのコピーに対する操作を表します。 - これはお望みの動作と異なるかもしれません。パフォーマンスやメモリ使用量の - 観点から、常に単一のインスタンスに対して操作を行いたくなることもあるでしょう。 + & 演算子を使用しない場合は、オブジェクトのコピーが + 作成されます。クラスの内部で $this を使用した場合、 + それはクラスの現在のインスタンスに対する操作を表します。 + & のない代入はインスタンス（オブジェクト）のコピーを + 行い、$this はそのコピーに対する操作を表します。 + これはお望みの動作と異なるかもしれません。パフォーマンスやメモリ使用量の + 観点から、常に単一のインスタンスに対して操作を行いたくなることもあるでしょう。 コンストラクタ内で @new のようにして @@ -115,15 +126,15 @@ &new を使用する場合にはこの機能は動作しません。 Zend Engine の仕様により、これはパースエラーとなります。 - - - - 関数の内部で global 宣言された変数にリファレンスを - 代入すると、そのリファレンスは関数の内部でのみ参照可能となります。 - これを避けるには、$GLOBALS 配列を使用します。 - - 関数内でのグローバル変数の参照 - + + + + 関数の内部で global 宣言された変数にリファレンスを + 代入すると、そのリファレンスは関数の内部でのみ参照可能となります。 + これを避けるには、$GLOBALS 配列を使用します。 + + 関数内でのグローバル変数の参照 + ]]> - - - global $var; は、$var - =& $GLOBALS['var']; の短縮版だと考えてください。 - これにより、他のリファレンスを $var に代入し、 - ローカル変数のリファレンスのみを変更します。 - - - - - &foreach; ステートメントの内部でリファレンス変数に値を代入すると、リファレンスも変更されます。 - - リファレンスと foreach ステートメント - + + + global $var; は、$var + =& $GLOBALS['var']; の短縮版だと考えてください。 + これにより、他のリファレンスを $var に代入し、 + ローカル変数のリファレンスのみを変更します。 + + + + + &foreach; ステートメントの内部でリファレンス変数に値を代入すると、リファレンスも変更されます。 + + リファレンスと foreach ステートメント + ]]> - - - - - - リファレンスの第 2 の使用法は、変数のリファレンス渡しです。この場合、 - 関数でローカル変数が作成され、コール側の変数が、それと同じ内容への - リファレンスとなります。例を示します。 - - + + + + + + + リファレンス渡し + + リファレンスの第 2 の使用法は、変数のリファレンス渡しです。この場合、 + 関数でローカル変数が作成され、コール側の変数が、それと同じ内容への + リファレンスとなります。例を示します。 + + ]]> - - - この結果、$a は 6 となります。これは、関数 - foo の中では、変数 $var は - $a と同じ内容を指しているためです。 - より詳細な説明は、 - リファレンス渡し - を参照ください。 - - - リファレンスの第 3 の使用法は、 - リファレンスによる返り値 - です。 - + + + この結果、$a は 6 となります。これは、関数 + foo の中では、変数 $var は + $a と同じ内容を指しているためです。 + より詳細な説明は、 + リファレンス渡し + を参照ください。 + + + + リファレンスによる返り値 + + リファレンスの第 3 の使用法は、 + リファレンスによる返り値 + です。 + + @@ -472,7 +490,7 @@ sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil -sgml-default-dtd-file:"../../manual.ced" +sgml-default-dtd-file:"~/.phpdoc/manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil Modified: phpdoc/ja/trunk/language-snippets.ent =================================================================== --- phpdoc/ja/trunk/language-snippets.ent 2009-10-11 00:06:17 UTC (rev 289510) +++ phpdoc/ja/trunk/language-snippets.ent 2009-10-11 00:14:30 UTC (rev 289511) @@ -1,6 +1,6 @@ - + 4.2.0 @@ -421,6 +421,8 @@ + +