File: stdclass.xml

package info (click to toggle)
php-doc 20241205~git.dfcbb86%2Bdfsg-1
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid, trixie
  • size: 70,956 kB
  • sloc: xml: 968,269; php: 23,883; javascript: 671; sh: 177; makefile: 37
file content (141 lines) | stat: -rw-r--r-- 3,451 bytes parent folder | download
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
-->