archived-doc-pt-br/reference/spl/splobjectstorage.xml

<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: dc6fe404e3bfc4b11c2f1d5acff1d071f7b41f3c Maintainer: leonardolara Status: ready --><!-- CREDITS: fernandowobeto,leonardolara -->
<reference xml:id="class.splobjectstorage" 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>A classe SplObjectStorage</title>
 <titleabbrev>SplObjectStorage</titleabbrev>

 <partintro>

<!-- {{{ SplObjectStorage intro -->
  <section xml:id="splobjectstorage.intro">
   &reftitle.intro;
   <para>
    A classe SplObjectStorage fornece um mapa de objetos para dados ou, ao
    ignorar os dados, um conjunto de objetos. Esse propósito duplo pode ser útil em muitos
    casos que envolvem a necessidade de identificar objetos de forma única.
   </para>
  </section>
<!-- }}} -->

  <section xml:id="splobjectstorage.synopsis">
   &reftitle.classsynopsis;

<!-- {{{ Synopsis -->
   <classsynopsis class="class">
    <ooclass>
     <classname>SplObjectStorage</classname>
    </ooclass>

    <oointerface>
     <modifier>implements</modifier>
     <interfacename>Countable</interfacename>
    </oointerface>

    <oointerface>
     <interfacename>SeekableIterator</interfacename>
    </oointerface>

    <oointerface>
     <interfacename>Serializable</interfacename>
    </oointerface>

    <oointerface>
     <interfacename>ArrayAccess</interfacename>
    </oointerface>

    <classsynopsisinfo role="comment">&Methods;</classsynopsisinfo>
    <xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.splobjectstorage')/db:refentry/db:refsect1[@role='description']/descendant::db:methodsynopsis[@role='SplObjectStorage'])">
     <xi:fallback/>
    </xi:include>
   </classsynopsis>
<!-- }}} -->

  </section>

<!-- {{{ splobjectstorage examples -->
  <section xml:id="splobjectstorage.examples">
   &reftitle.examples;
   <para>
    <example>
     <title><classname>SplObjectStorage</classname> como um conjunto</title>
     <programlisting role="php">
<![CDATA[
<?php
// Como um conjunto de objetos
$s = new SplObjectStorage();

$o1 = new stdClass;
$o2 = new stdClass;
$o3 = new stdClass;

$s->attach($o1);
$s->attach($o2);

var_dump($s->contains($o1));
var_dump($s->contains($o2));
var_dump($s->contains($o3));

$s->detach($o2);

var_dump($s->contains($o1));
var_dump($s->contains($o2));
var_dump($s->contains($o3));
?>
]]>
    </programlisting>
    &example.outputs;
    <screen>
<![CDATA[
bool(true)
bool(true)
bool(false)
bool(true)
bool(false)
bool(false)
]]>
     </screen>
    </example>
    <example>
     <title><classname>SplObjectStorage</classname> como um mapa</title>
     <programlisting role="php">
<![CDATA[
<?php
// Como um mapa de objetos para dados
$s = new SplObjectStorage();

$o1 = new stdClass;
$o2 = new stdClass;
$o3 = new stdClass;

$s[$o1] = "data for object 1";
$s[$o2] = array(1,2,3);

if (isset($s[$o2])) {
    var_dump($s[$o2]);
}
?>
]]>
    </programlisting>
    &example.outputs;
    <screen>
<![CDATA[
array(3) {
  [0]=>
  int(1)
  [1]=>
  int(2)
  [2]=>
  int(3)
}
]]>
     </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>
        Implementa <interfacename>SeekableIterator</interfacename>, anteriormente
        somente <interfacename>Iterator</interfacename> estava implementado.
       </entry>
      </row>
     </tbody>
    </tgroup>
   </informaltable>
  </section>

 </partintro>

 &reference.spl.entities.splobjectstorage;

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