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

<reference xml:id="class.streamwrapper" 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>Класс streamWrapper</title>

<titleabbrev>streamWrapper</titleabbrev>

<partintro>

<!-- {{{ streamWrapper intro -->

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

&reftitle.intro;

<para>

Позволяет реализовывать собственные обработчики протоколов и потоков для

дальнейшего использования со всеми функциями по работе с файловой системой

(такими как <function>fopen</function>, <function>fread</function> и т.п.).

</para>

<note>

<para>

Это <emphasis>НЕ</emphasis> реальный класс, а лишь прототип, предоставленный

в качестве наглядного пособия.

</para>

</note>

<note>

<para>

Реализация методов, отличная от описанной здесь, может привести к

неопределённому поведению.

</para>

</note>

<para>

Объект класса инициализируется в тот момент, когда потоковая функция

пытается получить доступ к протоколу, с которым этот класс ассоциирован.

</para>

</section>

<!-- }}} -->

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

&reftitle.classsynopsis;

<!-- {{{ Synopsis -->

<classsynopsis>

<ooclass><classname>streamWrapper</classname></ooclass>

<!-- {{{ Class synopsis -->

<classsynopsisinfo>

<ooclass>

<classname><replaceable>streamWrapper</replaceable></classname>

</ooclass>

</classsynopsisinfo>

<!-- }}} -->

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

<fieldsynopsis>

<modifier>public</modifier>

<type>resource</type>

<varname linkend="streamwrapper.props.context">context</varname>

</fieldsynopsis>

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

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

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

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

</classsynopsis>

<!-- }}} -->

</section>

<!-- {{{ streamWrapper properties -->

<section xml:id="streamwrapper.props">

&reftitle.properties;

<variablelist>

<varlistentry xml:id="streamwrapper.props.context">

<term>resource <varname>context</varname></term>

<listitem>

<para>

Текущий <link linkend="context">контекст</link> или &null;, если

в вызывающую функцию не было передано никакого контекста.

</para>

<para>

Используйте функцию <function>stream_context_get_options</function> для

анализа и разбора контекста.

</para>

<note>

<para>

Это свойство <emphasis>должно</emphasis> быть общедоступным (иметь

модификатор public), чтобы PHP мог ассоциировать его с актуальным контекстом.

</para>

</note>

</listitem>

</varlistentry>

</variablelist>

</section>

<!-- }}} -->

<section role="seealso"><!-- {{{ -->

&reftitle.seealso;

<para>

<simplelist>

<member><xref linkend="stream.streamwrapper.example-1" /></member>

<member><function>stream_wrapper_register</function></member>

<member><function>stream_wrapper_unregister</function></member>

<member><function>stream_wrapper_restore</function></member>

</simplelist>

</para>

</section><!-- }}} -->

</partintro>

&reference.stream.entities.streamwrapper;

</reference>