[PHP-DOC] cvs: phpdoc /cs/functions outcontrol.xml

[Roman Neuhauser]

cynic           Thu Jan 25 21:29:36 2001 EDT

  Added files:                 
    /phpdoc/cs/functions        outcontrol.xml 
  Log:
  
  
  translated. might need some polishing. (win-1250... somebody save my soul)
  

Index: phpdoc/cs/functions/outcontrol.xml
+++ phpdoc/cs/functions/outcontrol.xml
 <reference id="ref.outcontrol">
  <title>Output Control funkce</title>
  <titleabbrev>Output Control</titleabbrev>

  <partintro>
   <para>
    Output Control funkce (funkce pro ��zen� v�stupu) v�m umo��uj�c ovl�dat, kdy
    se ode�le v�stup skriptu. To m��e b�t u�ite�n� v n�kolika r�zn�ch situac�ch,
    zvl�t� pokud pot�ebujete poslat browseru hlavi�ky pot�, co v� skript
    za�al odes�lat data. Output Control funkce neovliv�uj� hlavi�ky odeslan�
    pomoc� <function>header</function> nebo <function>setcookie</function>,
    pouze funkce jako <function>echo</function> a data mezi bloky PHP k�du.
   </para>
   <para>
    <example>
     <title>Uk�zka ��zen� v�stupu</title>
     <programlisting role="php">
&lt;?php

ob_start();
echo "Hello\n";

setcookie ("cookiename", "cookiedata");

ob_end_flush();

?&gt;
     </programlisting>
    </example>
   </para>
   <para>
    Ve v��e uveden� uk�zce se v�stup z <function>echo</function> ulo�� ve
    v�stupn�m bufferu a� do vol�n� <function>ob_end_flush</function>. Mezit�m
    vol�n� <function>setcookie</function> �sp�n� ulo�ilo cookie bez vyvol�n�
    chyby. (Norm�ln� nem��ete odeslat do browseru hlavi�ky pot�, co u� byla
    odesl�na data.)
   </para>
   <para>
    Viz tak� <function>header</function> a <function>setcookie</function>.
   </para>
  </partintro>

  <refentry id="function.flush">
   <refnamediv>
    <refname>flush</refname>
    <refpurpose>Odeslat v�stupn� buffer</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Popis</title>
    <funcsynopsis>
     <funcprototype>
      <funcdef>void <function>flush</function></funcdef>
      <void/>
     </funcprototype>
    </funcsynopsis>
    <simpara>
     Vypr�zdn� v�stupn� buffery PHP a jak�hokoli backendu, kter� PHP pou��v�
     (CGI, web server, atd.) Ode�le ve�ker� dosavadn� v�stup do u�ivatelova
     browseru.
    </simpara>
    <note>
     <para>
      <function>flush</function> nem� ��dn� ��inek na bufferovac� sch�ma va�eho
      webserveru nebo browseru na klientsk� stran�.
     </para>
     <para>
      N�kter� servery, zvl�t� na Win32, bufferuj� v�stup a� do ukon�en� b�hu
      skriptu bez ohledu na <function>flush</function>, a a� potom ode�lou
      v�stup browseru.
     </para>
     <para>
      Browser m��e tak� bufferovat sv�j vstup p�ed zobrazen�m. Nap��klad
      Netscape bufferuje text do t� doby ne� p�ijme konec ��dku nebo za��tek
      tagu, a nezobraz� tabulku, dokud nedostane &lt;/table&gt; nejzevn�j��
      tabulky.
     </para>
    </note>
   </refsect1>
  </refentry>

  <refentry id="function.ob-start">
   <refnamediv>
    <refname>ob_start</refname>
    <refpurpose>Zapnout bufferov�n� v�stupu</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Popis</title>
    <funcsynopsis>
     <funcprototype>
      <funcdef>void <function>ob_start</function></funcdef>
      <paramdef>string
       <parameter>
        <optional>output_callback</optional>
       </parameter>
      </paramdef>
     </funcprototype>
    </funcsynopsis>
    <para>
     Tato funkce zap�n� bufferov�n� v�stupu. Pokud je bufferov�n� v�stupu
     aktivov�no, ��dn� v�stup ze skriptu se neode�le, m�sto toho se ukl�d� v
     intern�m bufferu.
    </para>
    <para>
     Obsah tohoto intern�ho bufferu je mo�no zkop�rovat do prom�nn� typu string
     pomoc� <function>ob_get_contents</function>. K odesl�n� obsahu intern�ho
     bufferu pou�ijte <function>ob_end_flush</function>. Naprotitomu
     <function>ob_end_clean</function> ti�e odstran� obsah v�stupn�ho bufferu.
    </para>
    <para>
     M��ete zadat voliteln� n�zev callback funkce, kter� se automaticky zavol�
     s obsahem bufferu jako argumentem. Tato funkce mus� p�ij�mat �et�zec a
     vracet �et�zec. Tato funkce bude vol�na p�i
     <function>ob_end_flush</function> a dostane obsah v�stupn�ho bufferu jako
     sv�j argument. Mus� vr�tit nov� v�stupn� buffer, kter� se pak vytiskne.
    </para>
    <para>
     V�stupn� buffery se daj� stackovat, tzn. m��ete zavolat
     <function>ob_start</function> zat�mco je aktivn� dal��
     <function>ob_start</function>. Je pot�eba pouze spr�vn� po�et vol�n�
     <function>ob_end_flush()</function>. Pokud je akivn�ch v�ce output callback
     funkc�, v�stup je filtrov�n postupn� p�es ka�dou z nich tak jak jsou do
     sebe vno�en�.
    </para>
    <example>
     <title>Uk�zka callback funkce</title>
     <programlisting role="php">
&lt;?php
function c($str) {
  // Druu Chunusun mut dum Kuntrubu�...
  return nl2br(ereg_replace("[aeiou]", "u", $str));
}

function d($str) {
  return strip_tags($str);
}
?>

&lt;?php ob_start("c"); ?&gt;
Drei Chinesen mit dem Kontraba�...
&lt;?php ob_start("d"); ?&gt;
&lt;h1&gt;..sa�en auf der Stra�e und erz�hlten sich was...&lt;/h1&gt;
&lt;?php ob_end_flush(); ?&gt;
.. da kam die Polizei, ja was ist denn das?
&lt;?php ob_end_flush(); ?&gt;

?&gt;
     </programlisting>
    </example>
    <para>
     Viz tak� <function>ob_get_contents</function>,
     <function>ob_end_flush</function>,
     <function>ob_end_clean</function>, and
     <function>ob_implicit_flush</function>
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.ob-get-contents">
   <refnamediv>
    <refname>ob_get_contents</refname>
    <refpurpose>Vr�tit obsah v�stupn�ho bufferu</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Popis</title>
    <funcsynopsis>
     <funcprototype>
      <funcdef>string <function>ob_get_contents</function></funcdef>
      <void/>
     </funcprototype>
    </funcsynopsis>
    <para>
     Tato funkce vr�t� obsah v�stupn�ho bufferu nebo <literal>false</literal>,
     pokud bufferov�n� v�stupu nen� aktivov�no.
    </para>
    <para>
     Viz tak� <function>ob_start</function> a <function>ob_get_length</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.ob-get-length">
   <refnamediv>
    <refname>ob_get_length</refname>
    <refpurpose>Vr�tit d�lku v�stupn�ho buffer</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Popis</title>
    <funcsynopsis>
     <funcprototype>
      <funcdef>string <function>ob_get_length</function></funcdef>
      <void/>
     </funcprototype>
    </funcsynopsis>
    <para>
     Tato funkce vr�t� d�lku obsahu v�stupn�ho bufferu nebo
     This will return the length of the contents in the output buffer, nebo
     <literal>false</literal>, pokud bufferov�n� v�stupu nen� aktivov�no.
    </para>
    <para>
     Viz tak� <function>ob_start</function> a
     <function>ob_get_contents</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.ob-end-flush">
   <refnamediv>
    <refname>ob_end_flush</refname>
    <refpurpose>
     Vypr�zdnit (odeslat) v�stupn� buffer a vypnout bufferov�n� v�stupu
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Popis</title>
    <funcsynopsis>
     <funcprototype>
      <funcdef>void <function>ob_end_flush</function></funcdef>
      <void/>
     </funcprototype>
    </funcsynopsis>
    <para>
     Tato funkce ode�le obsah v�stupn�ho bufferu (pokud n�jak� je) a vypne
     bufferov�n� v�stupu. Pokud chcete obsah v�stupn�ho bufferu d�le zpracov�vat,
     mus�te p�ed <function>ob_end_flush</function> zavolat
     <function>ob_get_contents</function>, proto�e obsah bufferu se po
     <function>ob_end_flush</function> odhod�.
    </para>
    <para>
     Viz tak� <function>ob_start</function>,
     <function>ob_get_contents</function> a
     <function>ob_end_clean</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.ob-end-clean">
   <refnamediv>
    <refname>ob_end_clean</refname>
    <refpurpose>
     Vy�istit (vymazat) v�stupn� buffer a vypnout bufferov�n� v�stupu
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Popis</title>
    <funcsynopsis>
     <funcprototype>
      <funcdef>void <function>ob_end_clean</function></funcdef>
      <void/>
     </funcprototype>
    </funcsynopsis>
    <para>
     Tato funkce odhod� obsah v�stupn�ho bufferu a vypne bufferov�n� v�stupu.
    </para>
    <para>
     Viz tak� <function>ob_start</function> a
     <function>ob_end_flush</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.ob-implicit-flush">
   <refnamediv>
    <refname>ob_implicit_flush</refname>
    <refpurpose>Vypnout/zapnout implicitn� flush</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Popis</title>
    <funcsynopsis>
     <funcprototype>
      <funcdef>void <function>ob_implicit_flush</function></funcdef>
      <paramdef>int
       <parameter><optional>flag</optional></parameter>
      </paramdef>
     </funcprototype>
    </funcsynopsis>
    <para>
     <function>ob_implicit_flush</function> vypne nebo zapne implicitn�
     flushov�n� (pokud nedostane ��dn� <parameter>flag</parameter>, default je
     zapnout). Implicitn� flushov�n� zp�sob� flush po ka�d�m vygenerov�n�
     v�stupu, tak�e u� nebudou pot�eba explicitn� vol�n�
     <function>flush</function>.
    </para>
    <para>
     Zapnut� implicitn�ho flushov�n� zru�� bufferov�n� v�stupu, a aktu�ln� obsah
     v�stupn�ch buffer� se ode�le jako p�i vol�n�
     <function>ob_end_flush</function>.
    </para>
    <para>
     Viz tak� <function>flush</function>,
     <function>ob_start</function> a
     <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
sgml-parent-document:nil
sgml-default-dtd-file:"../../manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
-->