reference/outcontrol/functions/ob-clean.xml
86b976d5afaf037868174fe5c242e886eb69baa4
86b976d5afaf037868174fe5c242e886eb69baa4
...
...
@@ -1,30 +1,50 @@
1
1
<?xml version="1.0" encoding="utf-8"?>
2
2
<!-- $Revision$ -->
3
-
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.ob-clean">
3
+
<refentry xml:id="function.ob-clean" xmlns="http://docbook.org/ns/docbook">
4
4
<refnamediv>
5
5
<refname>ob_clean</refname>
6
-
<refpurpose>Clean (erase) the output buffer</refpurpose>
6
+
<refpurpose>Clean (erase) the contents of the active output buffer</refpurpose>
7
7
</refnamediv>
8
8
9
9
<refsect1 role="description">
10
10
&reftitle.description;
11
11
<methodsynopsis>
12
-
<type>void</type><methodname>ob_clean</methodname>
12
+
<type>bool</type><methodname>ob_clean</methodname>
13
13
<void/>
14
14
</methodsynopsis>
15
15
<para>
16
-
This function discards the contents of the output buffer.
16
+
This function calls the output handler
17
+
(with the <constant>PHP_OUTPUT_HANDLER_CLEAN</constant> flag),
18
+
discards it's return value
19
+
and cleans (erases) the contents of the active output buffer.
17
20
</para>
18
21
<para>
19
-
This function does not destroy the output buffer like
20
-
<function>ob_end_clean</function> does.
22
+
This function does not turn off the active output buffer like
23
+
<function>ob_end_clean</function> or <function>ob_get_clean</function> does.
21
24
</para>
25
+
<para>
26
+
<function>ob_clean</function> will fail
27
+
without an active output buffer started with the
28
+
<constant>PHP_OUTPUT_HANDLER_CLEANABLE</constant> flag.
29
+
</para>
30
+
</refsect1>
31
+
32
+
<refsect1 role="parameters">
33
+
&reftitle.parameters;
34
+
&no.function.parameters;
22
35
</refsect1>
23
36
24
37
<refsect1 role="returnvalues">
25
38
&reftitle.returnvalues;
26
39
<para>
27
-
&return.void;
40
+
&return.success;
41
+
</para>
42
+
</refsect1>
43
+
44
+
<refsect1 role="errors">
45
+
&reftitle.errors;
46
+
<para>
47
+
If the function fails it generates an <constant>E_NOTICE</constant>.
28
48
</para>
29
49
</refsect1>
30
50
...
...
@@ -32,15 +52,16 @@
32
52
&reftitle.seealso;
33
53
<para>
34
54
<simplelist>
35
-
<member><function>ob_flush</function></member>
36
-
<member><function>ob_end_flush</function></member>
55
+
<member><function>ob_start</function></member>
56
+
<member><function>ob_get_contents</function></member>
37
57
<member><function>ob_end_clean</function></member>
58
+
<member><function>ob_get_clean</function></member>
59
+
<member><function>ob_flush</function></member>
38
60
</simplelist>
39
61
</para>
40
62
</refsect1>
41
63
42
64
</refentry>
43
-
44
65
<!-- Keep this comment at the end of the file
45
66
Local variables:
46
67
mode: sgml
47
68