cvs: phpdoc /cs/functions outcontrol.xml
| From: | Roman Neuhauser | 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 odele výstup skriptu. To mùe být uiteè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"> <?php ob_start(); echo "Hello\n"; setcookie ("cookiename", "cookiedata"); ob_end_flush(); ?> </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ì uloilo 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.) Odele vekerý dosavadní výstup do uivatelova browseru. </simpara> <note> <para> <function>flush</function> nemá ádný úèinek na bufferovací schéma vaeho 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 odelou 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 </table> 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 neodele, místo toho se ukládá v interním bufferu. </para> <para> Obsah tohoto interního bufferu je mono zkopírovat do promìnné typu string pomocí <function>ob_get_contents</function>. K odeslání obsahu interního bufferu pouijte <function>ob_end_flush</function>. Naprotitomu <function>ob_end_clean</function> tie 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 kadou z nich tak jak jsou do sebe vnoøené. </para> <example> <title>Ukázka callback funkce</title> <programlisting role="php"> <?php function c($str) { // Druu Chunusun mut dum Kuntrubuß... return nl2br(ereg_replace("[aeiou]", "u", $str)); } function d($str) { return strip_tags($str); } ?> <?php ob_start("c"); ?> Drei Chinesen mit dem Kontrabaß... <?php ob_start("d"); ?> <h1>..saßen auf der Straße und erzählten sich was...</h1> <?php ob_end_flush(); ?> ... da kam die Polizei, ja was ist denn das? <?php ob_end_flush(); ?> ?> </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 odele 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>, protoe 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 kadém vygenerování výstupu, take 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 odele 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: -->
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 odele výstup skriptu. To mùe být uiteè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"> <?php ob_start(); echo "Hello\n"; setcookie ("cookiename", "cookiedata"); ob_end_flush(); ?> </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ì uloilo 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.) Odele vekerý dosavadní výstup do uivatelova browseru. </simpara> <note> <para> <function>flush</function> nemá ádný úèinek na bufferovací schéma vaeho 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 odelou 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 </table> 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 neodele, místo toho se ukládá v interním bufferu. </para> <para> Obsah tohoto interního bufferu je mono zkopírovat do promìnné typu string pomocí <function>ob_get_contents</function>. K odeslání obsahu interního bufferu pouijte <function>ob_end_flush</function>. Naprotitomu <function>ob_end_clean</function> tie 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 kadou z nich tak jak jsou do sebe vnoøené. </para> <example> <title>Ukázka callback funkce</title> <programlisting role="php"> <?php function c($str) { // Druu Chunusun mut dum Kuntrubuß... return nl2br(ereg_replace("[aeiou]", "u", $str)); } function d($str) { return strip_tags($str); } ?> <?php ob_start("c"); ?> Drei Chinesen mit dem Kontrabaß... <?php ob_start("d"); ?> <h1>..saßen auf der Straße und erzählten sich was...</h1> <?php ob_end_flush(); ?> ... da kam die Polizei, ja was ist denn das? <?php ob_end_flush(); ?> ?> </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 odele 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>, protoe 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 kadém vygenerování výstupu, take 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 odele 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: -->