1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141
|
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<reference xml:id="class.stdclass" 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>The stdClass class</title>
<titleabbrev>stdClass</titleabbrev>
<partintro>
<section xml:id="stdclass.intro">
&reftitle.intro;
<para>
A generic empty class with dynamic properties.
</para>
<para>
Objects of this class can be instantiated with
<link linkend="language.oop5.basic.new">new</link> operator or created by
<link linkend="language.types.object.casting">typecasting to object</link>.
Several PHP functions also create instances of this class, e.g.
<function>json_decode</function>, <function>mysqli_fetch_object</function>
or <methodname>PDOStatement::fetchObject</methodname>.
</para>
<para>
Despite not implementing
<link linkend="object.get">__get()</link>/<link linkend="object.set">__set()</link>
magic methods, this class allows dynamic properties and does not require the
<code>#[\AllowDynamicProperties]</code> attribute.
</para>
<para>
This is not a base class as PHP does not have a concept of a universal base
class. However, it is possible to create a custom class that extends from
<classname>stdClass</classname> and as a result inherits the functionality
of dynamic properties.
</para>
</section>
<section xml:id="stdclass.synopsis">
&reftitle.classsynopsis;
<classsynopsis class="class">
<ooclass>
<classname>stdClass</classname>
</ooclass>
</classsynopsis>
<para>
This class has no methods or default properties.
</para>
</section>
<section xml:id="stdclass.examples" role="examples">
&reftitle.examples;
<example xml:id="stdclass.basic-example">
<title>Created as a result of typecasting to object</title>
<programlisting role="php">
<![CDATA[
<?php
$obj = (object) array('foo' => 'bar');
var_dump($obj);
]]>
</programlisting>
&example.outputs;
<screen>
<![CDATA[
object(stdClass)#1 (1) {
["foo"]=>
string(3) "bar"
}
]]>
</screen>
</example>
<example xml:id="stdclass.json-example">
<title>Created as a result of <function>json_decode</function></title>
<programlisting role="php">
<![CDATA[
<?php
$json = '{"foo":"bar"}';
var_dump(json_decode($json));
]]>
</programlisting>
&example.outputs;
<screen>
<![CDATA[
object(stdClass)#1 (1) {
["foo"]=>
string(3) "bar"
}
]]>
</screen>
</example>
<example xml:id="stdclass.properties-example">
<title>Declaring dynamic properties</title>
<programlisting role="php">
<![CDATA[
<?php
$obj = new stdClass();
$obj->foo = 42;
$obj->{1} = 42;
var_dump($obj);
]]>
</programlisting>
&example.outputs;
<screen>
<![CDATA[
object(stdClass)#1 (2) {
["foo"]=>
int(42)
["1"]=>
int(42)
}
]]>
</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
-->
|