reference/var/functions/empty.xml
4a07033f7ac5ab121357051cc94ec48b9f6f58fc
...
...
@@ -25,14 +25,6 @@
25
25
<para>
26
26
Variable to be checked
27
27
</para>
28
-
<note>
29
-
<para>
30
-
Prior to PHP 5.5, <function>empty</function> only supports variables;
31
-
anything else will result in a parse error. In other words, the
32
-
following will not work: <command>empty(trim($name))</command>.
33
-
Instead, use <command>trim($name) == false</command>.
34
-
</para>
35
-
</note>
36
28
<para>
37
29
No warning is generated if the variable does not exist.
38
30
That means <function>empty</function> is essentially the
...
...
@@ -46,20 +38,9 @@
46
38
<refsect1 role="returnvalues">
47
39
&reftitle.returnvalues;
48
40
<para>
49
-
Returns &false; if <parameter>var</parameter> exists and has a non-empty, non-zero value.
50
-
Otherwise returns &true;.
51
-
</para>
52
-
<para>
53
-
The following values are considered to be empty:
54
-
<simplelist>
55
-
<member><literal>""</literal> (an empty string)</member>
56
-
<member><literal>0</literal> (0 as an integer)</member>
57
-
<member><literal>0.0</literal> (0 as a float)</member>
58
-
<member><literal>"0"</literal> (0 as a string)</member>
59
-
<member>&null;</member>
60
-
<member>&false;</member>
61
-
<member><literal>array()</literal> (an empty array)</member>
62
-
</simplelist>
41
+
Returns &true; if <parameter>var</parameter> does not exist or has a value that is empty or equal to zero,
42
+
aka falsey, see <link linkend="language.types.boolean.casting">conversion to boolean</link>.
43
+
Otherwise returns &false;.
63
44
</para>
64
45
</refsect1>
65
46
<refsect1 role="examples">
...
...
@@ -91,10 +72,6 @@ if (isset($var)) {
91
72
</para>
92
73
<example>
93
74
<title><function>empty</function> on String Offsets</title>
94
-
<para>
95
-
PHP 5.4 changes how <function>empty</function> behaves
96
-
when passed string offsets.
97
-
</para>
98
75
<programlisting role="php">
99
76
<![CDATA[
100
77
<?php
...
...
@@ -108,18 +85,7 @@ var_dump(empty($expected_array_got_string['0 Mostel']));
108
85
?>
109
86
]]>
110
87
</programlisting>
111
-
&example.outputs.53;
112
-
<screen>
113
-
<![CDATA[
114
-
bool(false)
115
-
bool(false)
116
-
bool(false)
117
-
bool(false)
118
-
bool(false)
119
-
bool(false)
120
-
]]>
121
-
</screen>
122
-
&example.outputs.54;
88
+
&example.outputs;
123
89
<screen>
124
90
<![CDATA[
125
91
bool(true)
126
92