<?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">счётчик ссылок</link> на исходный объект

сбросится до нуля; слабые ссылки не увеличивают счётчик ссылок <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>