<?xml version="1.0" encoding="utf-8"?>

<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>

<titleabbrev>WeakReference</titleabbrev>

<partintro>

<section xml:id="weakreference.intro">

&reftitle.intro;

<para>

弱い参照により、オブジェクトが破棄されるのを妨げないオブジェクトへの参照を保持することが可能です。

この機能は、キャッシュのようなデータ構造を実装するのに役立ちます。

元のオブジェクトが破棄されている場合、<methodname>WeakReference::get</methodname>

メソッドを呼び出すと &null; を返します。

元のオブジェクトは、<link linkend="features.gc.refcounting-basics">refcount</link> が 0 になると破棄されます。

弱い参照を作成しても、参照されているオブジェクトの <literal>refcount</literal> は増加しません。

</para>

<para>

<classname>WeakReference</classname> クラスはシリアライズできません。

</para>

</section>

<section xml:id="weakreference.synopsis">

&reftitle.classsynopsis;

<classsynopsis class="class">

<ooclass>

<modifier>final</modifier>

<classname>WeakReference</classname>

</ooclass>

<classsynopsisinfo role="comment">&Methods;</classsynopsisinfo>

<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.weakreference')/db:refentry/db:refsect1[@role='description']/descendant::db:constructorsynopsis[@role='WeakReference'])">

<xi:fallback/>

</xi:include>

<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.weakreference')/db:refentry/db:refsect1[@role='description']/descendant::db:methodsynopsis[@role='WeakReference'])">

<xi:fallback/>

</xi:include>

</classsynopsis>

</section>

<section xml:id="weakreference.examples">

<title>WeakReference の例</title>

<para>

<example xml:id="weakreference.basic-example">

<title>基本的な WeakReference クラスの使い方</title>

<programlisting role="php">

</programlisting>

&example.outputs.similar;

<screen>

</screen>

</example>

</para>

</section>

<section role="changelog">

&reftitle.changelog;

<informaltable>

<tgroup cols="2">

<thead>

<row>

<entry>&Version;</entry>

<entry>&Description;</entry>

</row>

</thead>

<tbody>

<row>

<entry>8.4.0</entry>

<entry>

<methodname>WeakReference::__debugInfo</methodname> の出力に、

参照されたオブジェクトを含むようになりました。また、参照が有効ではなくなっている場合は、

参照されたオブジェクトは <literal>NULL</literal> となります。

</entry>

</row>

</tbody>

</tgroup>

</informaltable>

</section>

</partintro>

&language.predefined.weakreference.construct;

&language.predefined.weakreference.create;

&language.predefined.weakreference.get;

</reference>