php-doc-en/reference/outcontrol/functions/ob-get-status.xml
Hartmut Holzgraefe f953a0f164 added description of output fields
git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@203793 c90b9560-bf6c-de11-be94-00142212c4b1
2005-12-27 21:08:51 +00:00

128 lines
4.1 KiB
XML

<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.3 $ -->
<refentry id="function.ob-get-status">
<refnamediv>
<refname>ob_get_status</refname>
<refpurpose>
Get status of output buffers
</refpurpose>
</refnamediv>
<refsect1>
<title>Description</title>
<methodsynopsis>
<type>array</type><methodname>ob_get_status</methodname>
<methodparam choice="opt">
<type>bool</type>
<parameter>full_status</parameter>
<initializer>FALSE</initializer>
</methodparam>
</methodsynopsis>
<para>
<function>ob_get_status</function> returns status information on
either the top level output buffer or all active output buffer levels
if <parameter>full_status</parameter> is set to &true;.
</para>
<para>
If called without the <parameter>full_status</parameter> parameter
or with <parameter>full_status</parameter> = &false; a simple array
with the following elements is returned:
</para>
<example>
<title>Simple <function>ob_get_status</function> output</title>
<screen>
Array
(
[level] => 2
[type] => 0
[status] => 0
[name] => URL-Rewriter
[del] => 1
)
</screen>
</example>
<para>
<segmentedlist>
<title>Simple <function>ob_get_status</function> results</title>
<segtitle>Key</segtitle><segtitle>Value</segtitle>
<seglistitem><seg>level</seg><seg>Output nesting level</seg></seglistitem>
<seglistitem><seg>type</seg><seg><literal>PHP_OUTPUT_HANDLER_INTERNAL (0)</literal> or <literal>PHP_OUTPUT_HANDLER_USER (1)</literal></seg></seglistitem>
<seglistitem><seg>status</seg><seg>One of <literal>PHP_OUTPUT_HANDLER_START</literal> (0), <literal>PHP_OUTPUT_HANDLER_CONT</literal> (1) or <literal>PHP_OUTPUT_HANDLER_END</literal> (2)</seg></seglistitem>
<seglistitem><seg>name</seg><seg>Name of active output handler or ' default output handler' if none is set</seg></seglistitem>
<seglistitem><seg>del</seg><seg>Erase-flag as set by <function>ob_start</function></seg></seglistitem>
</segmentedlist>
</para>
<para>
If called with <parameter>full_status</parameter> = &true; an array
with one element for each active output buffer level is returned.
The output level is used as key of the top level array and each array
element itself is another array holding status information
on one active output level.
</para>
<example>
<title>Full <function>ob_get_status</function> output</title>
<screen>
Array
(
[0] => Array
(
[chunk_size] => 0
[size] => 40960
[block_size] => 10240
[type] => 1
[status] => 0
[name] => default output handler
[del] => 1
)
[1] => Array
(
[chunk_size] => 0
[size] => 40960
[block_size] => 10240
[type] => 0
[buffer_size] => 0
[status] => 0
[name] => URL-Rewriter
[del] => 1
)
)
</screen>
</example>
<para>
The full output contains these additional elements:
<segmentedlist>
<title>Full <function>ob_get_status</function> results</title>
<segtitle>Key</segtitle><segtitle>Value</segtitle>
<seglistitem><seg>chunk_size</seg><seg>Chunk size as set by <function>ob_start</function></seg></seglistitem>
<seglistitem><seg>size</seg><seg>...</seg></seglistitem>
<seglistitem><seg>blocksize</seg><seg>...</seg></seglistitem>
</segmentedlist>
</para>
<para>
See also <function>ob_get_level</function> and
<function>ob_list_handlers</function>.
</para>
</refsect1>
</refentry>
<!-- 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:"../../../../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
-->