Files
archived-doc-pt-br/reference/pthreads/volatile.xml
Leonardo Lara Rodrigues 17d859faaf sync line numbers with en rev
2026-01-23 09:16:58 -03:00

142 lines
3.7 KiB
XML

<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: bf92d8bd839301de7c837d20ab1dac6c14f83bbf Maintainer: fernandowobeto Status: ready --><!-- CREDITS: fernandowobeto -->
<reference xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude" xml:id="class.volatile" role="class">
<title>A classe Volatile</title>
<titleabbrev>Volatile</titleabbrev>
<partintro>
<!-- {{{ Volatile intro -->
<section xml:id="volatile.intro">
&reftitle.intro;
<simpara>
A classe <classname>Volatile</classname> é nova no pthreads v3. Sua
introdução é consequência da nova semântica de imutabilidade dos membros
<classname>Threaded</classname> das classes <classname>Threaded</classname>.
A classe <classname>Volatile</classname> permite a mutabilidade de seus
membros <classname>Threaded</classname> e também é usada para armazenar
arrays PHP em contextos <classname>Threaded</classname>.
</simpara>
</section>
<!-- }}} -->
<section xml:id="volatile.synopsis">
&reftitle.classsynopsis;
<!-- {{{ Synopsis -->
<classsynopsis>
<ooclass><classname>Volatile</classname></ooclass>
<!-- {{{ Class synopsis -->
<classsynopsisinfo>
<ooclass>
<classname>Volatile</classname>
</ooclass>
<ooclass>
<modifier>extends</modifier>
<classname>Threaded</classname>
</ooclass>
<oointerface>
<interfacename>Collectable</interfacename>
</oointerface>
<oointerface>
<interfacename>Traversable</interfacename>
</oointerface>
</classsynopsisinfo>
<classsynopsisinfo role="comment">&InheritedMethods;</classsynopsisinfo>
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.threaded')/db:refentry/db:refsect1[@role='description']/descendant::db:methodsynopsis[not(@role='procedural')])">
<xi:fallback/>
</xi:include>
</classsynopsis>
<!-- }}} -->
</section>
<section xml:id="volatile.examples">
&reftitle.examples;
<example xml:id="volatile.example.immutable"><!-- {{{ -->
<title>Nova semântica de imutabilidade do Threaded</title>
<programlisting role="php">
<![CDATA[
<?php
class Task extends Threaded
{
public function __construct()
{
$this->data = new Threaded();
// tentativa de substituir uma propriedade Threaded de uma classe Threaded (inválida)
$this->data = new stdClass();
}
}
var_dump((new Task())->data);
]]>
</programlisting>
&example.outputs.similar;
<screen>
<![CDATA[
RuntimeException: Threaded members previously set to Threaded objects are immutable, cannot overwrite data in %s:%d
]]>
</screen>
</example><!-- }}} -->
<example xml:id="volatile.example.basic"><!-- {{{ -->
<title>Volatile use-case</title>
<programlisting role="php">
<![CDATA[
<?php
class Task extends Volatile
{
public function __construct()
{
$this->data = new Threaded();
// tentativa de substituir uma propriedade Threaded de uma classe Volatile (válido)
$this->data = new stdClass();
}
}
var_dump((new Task())->data);
]]>
</programlisting>
&example.outputs.similar;
<screen>
<![CDATA[
object(stdClass)#3 (0) {
}
]]>
</screen>
</example><!-- }}} -->
</section>
</partintro>
</reference>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"~/.phpdoc/manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->