Add more details about WeakReferences (#3976)の取り込み

php/doc-en@cd391e6

Author: siwa32

language/predefined/weakreference.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 14767af0f05dffa6fdb9b49e1a1f4e9ca7022a60 Maintainer: mumumu Status: ready -->
+<!-- EN-Revision: cd391e65a613a729f9bbded2b1249e2d7143400c Maintainer: mumumu Status: ready -->
 <reference xml:id="class.weakreference" role="class" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude">
 
  <title>WeakReference クラス</title>
@@ -14,6 +14,10 @@
    <para>
     弱い参照により、オブジェクトが破棄されるのを妨げないオブジェクトへの参照を保持することが可能です。
     この機能は、キャッシュのようなデータ構造を実装するのに役立ちます。
+    元のオブジェクトが破棄されている場合、<methodname>WeakReference::get</methodname>
+    メソッドを呼び出すと &null; を返します。
+    元のオブジェクトは、<link linkend="features.gc.refcounting-basics">refcount</link> が 0 になると破棄されます。
+    弱い参照を作成しても、参照されているオブジェクトの <literal>refcount</literal> は増加しません。
    </para>
    <para>
     <classname>WeakReference</classname> クラスはシリアライズできません。
@@ -51,11 +55,16 @@
      <programlisting role="php">
 <![CDATA[
 <?php
+
 $obj = new stdClass;
 $weakref = WeakReference::create($obj);
+
 var_dump($weakref->get());
+
 unset($obj);
+
 var_dump($weakref->get());
+
 ?>
 ]]>
      </programlisting>