<?xml version="1.0" encoding="iso-8859-1"?>
 <reference id="ref.outcontrol">
  <title>Funktionen zur Ausgabesteuerung</title>
  <titleabbrev>Output Control</titleabbrev>

  <partintro>
   <para>
    Mit den Funktionen zur Ausgabesteuerung knnen Sie die Ausgabe
    eines Skripts steuern. Dies kann in verschiedenen Situationen
    ganz ntzlich sein, besonders, wenn Sie header an den Browser
    schicken mssen, nachdem Ihr Skript bereits etwas ausgegeben
    hat. Die Ausgabesteuerungsfunktionen gelten nicht fr header,
    die mit <function>header</function> oder <function>setcookie</function>
    geschickt wurden, sondern nur fr Daten ,die mit <function>echo</function>
    gesendet wurden oder fr Daten zwischen PHP-Codeblcken.
   </para>
   <para>
    <example>
     <title>Beispiel Ausgabesteuerung </title>
     <programlisting role="php">
&lt;?php

ob_start();
echo "Hello\n";

setcookie ("cookiename", "cookiedata");

ob_end_flush();

?&gt;
     </programlisting>
    </example>
   </para>
   <para>
    Im obigen Beispiel wird die Ausgabe der <function>echo</function>
    solange im Ausgabepuffer zwischengespeichert, bis die Funktion
    <function>ob_end_flush</function> aufgeufen wird. In der
    Zwischenzeit speichert der Aufruf von <function>setcookie</function>
    erfolgreich einen Cookie, ohne einen Fehler zu erzeugen.
    (Normalerweise knnen Sie keine header an den Browser mehr
    schicken, wenn schon Daten ausgegeben wurden.)
   </para>
   <para>
    Siehe auch <function>header</function> und
    <function>setcookie</function>.
   </para>
  </partintro>

  <refentry id="function.flush">
   <refnamediv>
    <refname>flush</refname>
    <refpurpose>
     Der Ausgabe-Puffer wird geleert und alle Zeichen ausgegeben
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung:</title>
     <methodsynopsis>
      <type>void</type><methodname>flush</methodname>
      <void/>
     </methodsynopsis>
    <simpara>
     Unabhngig davon, wie PHP luft (CGI oder WEB-Server), wird der
     gesamte Ausgabe-Puffer geleert. Dabei wird versucht den ganzen
     Inhalt an den Browser des Benutzers zu schicken.
    </simpara>
   </refsect1>
  </refentry>

  <refentry id="function.ob-start">
   <refnamediv>
    <refname>ob_start</refname>
    <refpurpose>
                 Einschalten der Pufferung von Ausgaben
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung:</title>
     <methodsynopsis>
      <type>void</type><methodname>ob_start</methodname>
                  <void/>
     </methodsynopsis>
    <para>
     Diese Funktion schaltet die Pufferung von Ausgaben ein. Solange
     die Ausgabe-Pufferung aktiv ist, erfolgt keine Ausgabe bei der
     Skript-Ausfhrung. Statt dessen werden alle Ausgaben in einem
     internen Puffer gespeichert.
    </para>
          <para>
     Der Inhalt diese internen Puffers kann in eine String-Variable
     kopiert werden (per <function>ob_get_contents</function>). Die
     Ausgabe erfolgt erst bei Aufruf von
     <function>ob_end_flush</function> und sobald der Puffer-Inhalt per
     <function>ob_end_clean</function> verworfen wird.
                </para>
    <para>
     Siehe auch <function>ob_get_contents</function>,
                 <function>ob_end_flush</function>,
                 <function>ob_end_clean</function> und
     <function>ob_implicit_flush</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.ob-get-contents">
   <refnamediv>
    <refname>ob_get_contents</refname>
    <refpurpose>
     Gibt den Inhalt des Ausgabe-Puffers zurck
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung:</title>
     <methodsynopsis>
      <type>string</type><methodname>ob_get_contents</methodname>
                  <void/>
     </methodsynopsis>
    <para>
     Damit wird der Inhalt des Ausgabe-Puffers zurck gegeben (oder
     &false;, wenn die Ausgabe-Pufferung nicht aktiv ist).
    </para>
    <para>
     Siehe auch <function>ob_start</function>,
                 <function>ob_end_flush</function> und
     <function>ob_end_clean</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.ob-end-flush">
   <refnamediv>
    <refname>ob_end_flush</refname>
    <refpurpose>
     Leert (schickt/sendet) den Ausgabe-Puffer und deaktiviert die
     Ausgabe-Pufferung
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung:</title>
     <methodsynopsis>
      <type>void</type><methodname>ob_end_flush</methodname>
                  <void/>
     </methodsynopsis>
    <para>
     Der Inhalt des Ausgabe-Puffers (sofern vorhanden) wird abgeschickt
     und die Pufferung der Ausgabe deaktiviert. Falls sie mit dem
     Puffer-Inhalt weiter arbeiten mchten, mssen sie diesen erst per
     <function>ob_get_contents</function> zwischen speichern bevor sie
     <function>ob_end_flush</function> aufrufen, da dadurch der Puffer
     geleert wird.
    </para>
    <para>
     Siehe auch <function>ob_start</function>,
                 <function>ob_get_contents</function> und
                 <function>ob_end_clean</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.ob-end-clean">
   <refnamediv>
          <refname>ob_end_clean</refname>
    <refpurpose>
     Bereinigt (lscht) den Ausgabe-Puffer und deaktiviert die
     Ausgabe-Pufferung
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung:</title>
     <methodsynopsis>
      <type>void</type><methodname>ob_end_clean</methodname>
                  <void/>
     </methodsynopsis>
    <para>
     Diese Funktion verwirft den Inhalt des Ausgabe-Puffers und
     deaktiviert die Pufferung.
    </para>
    <para>
     Siehe auch <function>ob_start</function> und
                 <function>ob_end_flush</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.ob-implicit-flush">
   <refnamediv>
    <refname>ob_implicit_flush</refname>
    <refpurpose>
                 Schaltet die implizite Ausgabe ein bzw. aus
          </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung:</title>
     <methodsynopsis>
      <type>void</type><methodname>ob_implicit_flush</methodname>
                  <methodparam choice="opt"><type>int</type><parameter>flag</parameter></methodparam>
                 </methodsynopsis>
    <para>
     <function>ob_implicit_flush</function> schaltet die implizite
     Ausgabe an oder aus (wenn kein <parameter>flag</parameter>
     angegeben wurde, wird per default "Ein" angenommen). Die implizite
     Puffer-Ausgabe erzeugt eine Ausgabe nach jedem Ausgabe-Befehl, so
     dass keine Extra-Aufrufe von <function>flush</function> mehr
     erforderlich sind.
    </para>
    <para>
     Das Einschalten der impliziten Ausgabe beendet die Pufferung der
     Ausgabe. Der aktuelle Puffer-Inhalt wird ausgegeben, so als ob die
     Funktion <function>ob_end_flush</function> aufgerufen wurde.
    </para>
    <para>
     Siehe auch <function>flush</function>,
                 <function>ob_start</function> und
     <function>ob_end_flush</function>.
    </para>
   </refsect1>
  </refentry>

 </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:"../../manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
-->