cvs: phpdoc /cs/functions outcontrol.xml

From: Date: Fri, 26 Jan 2001 05:29:36 +0000
Subject: cvs: phpdoc /cs/functions outcontrol.xml
Groups: php.doc 
Request: Send a blank email to phpdoc+get-969333952@lists.php.net to get a copy of this message
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: -->
« previous php.doc (#969333952) next »