File: outcontrol.xml

package info (click to toggle)
phpdoc 20020310-1
  • links: PTS
  • area: main
  • in suites: woody
  • size: 35,272 kB
  • ctags: 354
  • sloc: xml: 799,767; php: 1,395; cpp: 500; makefile: 200; sh: 140; awk: 51
file content (297 lines) | stat: -rw-r--r-- 9,422 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
<?xml version="1.0" encoding="iso-8859-2"?>
 <reference id="ref.outcontrol">
  <title>Output Control funkce</title>
  <titleabbrev>Output Control</titleabbrev>

  <partintro>
   <para>
    Output Control funkce (funkce pro zen vstupu) vm umoujc ovldat, kdy
    se odele vstup skriptu. To me bt uiten v nkolika rznch situacch,
    zvlt pokud potebujete poslat browseru hlaviky pot, co v skript
    zaal odeslat data. Output Control funkce neovlivuj hlaviky odeslan
    pomoc <function>header</function> nebo <function>setcookie</function>,
    pouze funkce jako <function>echo</function> a data mezi bloky PHP kdu.
   </para>
   <para>
    <example>
     <title>Ukzka zen vstupu</title>
     <programlisting role="php">
&lt;?php

ob_start();
echo "Hello\n";

setcookie ("cookiename", "cookiedata");

ob_end_flush();

?&gt;
     </programlisting>
    </example>
   </para>
   <para>
    Ve ve uveden ukzce se vstup z <function>echo</function> ulo ve
    vstupnm bufferu a do voln <function>ob_end_flush</function>. Mezitm
    voln <function>setcookie</function> spn uloilo cookie bez vyvoln
    chyby. (Normln nemete odeslat do browseru hlaviky pot, co u byla
    odeslna data.)
   </para>
   <para>
    Viz tak <function>header</function> a <function>setcookie</function>.
   </para>
  </partintro>

  <refentry id="function.flush">
   <refnamediv>
    <refname>flush</refname>
    <refpurpose>Odeslat vstupn buffer</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Popis</title>
     <methodsynopsis>
      <type>void</type><methodname>flush</methodname>
      <void/>
     </methodsynopsis>
    <simpara>
     Vyprzdn vstupn buffery PHP a jakhokoli backendu, kter PHP pouv
     (CGI, web server, atd.) Odele veker dosavadn vstup do uivatelova
     browseru.
    </simpara>
    <note>
     <para>
      <function>flush</function> nem dn inek na bufferovac schma vaeho
      webserveru nebo browseru na klientsk stran.
     </para>
     <para>
      Nkter servery, zvlt na Win32, bufferuj vstup a do ukonen bhu
      skriptu bez ohledu na <function>flush</function>, a a potom odelou
      vstup browseru.
     </para>
     <para>
      Browser me tak bufferovat svj vstup ped zobrazenm. Napklad
      Netscape bufferuje text do t doby ne pijme konec dku nebo zatek
      tagu, a nezobraz tabulku, dokud nedostane &lt;/table&gt; nejzevnj
      tabulky.
     </para>
    </note>
   </refsect1>
  </refentry>

  <refentry id="function.ob-start">
   <refnamediv>
    <refname>ob_start</refname>
    <refpurpose>Zapnout bufferovn vstupu</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Popis</title>
     <methodsynopsis>
      <type>void</type><methodname>ob_start</methodname>
      <methodparam choice="opt"><type>string</type><parameter>
        output_callback
       </parameter></methodparam>
     </methodsynopsis>
    <para>
     Tato funkce zapn bufferovn vstupu. Pokud je bufferovn vstupu
     aktivovno, dn vstup ze skriptu se neodele, msto toho se ukld v
     internm bufferu.
    </para>
    <para>
     Obsah tohoto internho bufferu je mono zkoprovat do promnn typu string
     pomoc <function>ob_get_contents</function>. K odesln obsahu internho
     bufferu pouijte <function>ob_end_flush</function>. Naprotitomu
     <function>ob_end_clean</function> tie odstran obsah vstupnho bufferu.
    </para>
    <para>
     Mete zadat voliteln nzev callback funkce, kter se automaticky zavol
     s obsahem bufferu jako argumentem. Tato funkce mus pijmat etzec a
     vracet etzec. Tato funkce bude volna pi
     <function>ob_end_flush</function> a dostane obsah vstupnho bufferu jako
     svj argument. Mus vrtit nov vstupn buffer, kter se pak vytiskne.
    </para>
    <para>
     Vstupn buffery se daj stackovat, tzn. mete zavolat
     <function>ob_start</function> zatmco je aktivn dal
     <function>ob_start</function>. Je poteba pouze sprvn poet voln
     <function>ob_end_flush()</function>. Pokud je akivnch vce output callback
     funkc, vstup je filtrovn postupn pes kadou z nich tak jak jsou do
     sebe vnoen.
    </para>
    <example>
     <title>Ukzka 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;..saen auf der Strae und erzhlten 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>Vrtit obsah vstupnho bufferu</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Popis</title>
     <methodsynopsis>
      <type>string</type><methodname>ob_get_contents</methodname>
      <void/>
     </methodsynopsis>
    <para>
     Tato funkce vrt obsah vstupnho bufferu nebo &false;,
     pokud bufferovn vstupu nen aktivovno.
    </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>Vrtit dlku vstupnho buffer</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Popis</title>
     <methodsynopsis>
      <type>string</type><methodname>ob_get_length</methodname>
      <void/>
     </methodsynopsis>
    <para>
     Tato funkce vrt dlku obsahu vstupnho bufferu nebo
     This will return the length of the contents in the output buffer, nebo
     &false;, pokud bufferovn vstupu nen aktivovno.
    </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>
     Vyprzdnit (odeslat) vstupn buffer a vypnout bufferovn vstupu
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Popis</title>
     <methodsynopsis>
      <type>void</type><methodname>ob_end_flush</methodname>
      <void/>
     </methodsynopsis>
    <para>
     Tato funkce odele obsah vstupnho bufferu (pokud njak je) a vypne
     bufferovn vstupu. Pokud chcete obsah vstupnho bufferu dle zpracovvat,
     muste ped <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>
     Vyistit (vymazat) vstupn buffer a vypnout bufferovn vstupu
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Popis</title>
     <methodsynopsis>
      <type>void</type><methodname>ob_end_clean</methodname>
      <void/>
     </methodsynopsis>
    <para>
     Tato funkce odhod obsah vstupnho bufferu a vypne bufferovn vstupu.
    </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>
     <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> vypne nebo zapne implicitn
     flushovn (pokud nedostane dn <parameter>flag</parameter>, default je
     zapnout). Implicitn flushovn zpsob flush po kadm vygenerovn
     vstupu, take u nebudou poteba explicitn voln
     <function>flush</function>.
    </para>
    <para>
     Zapnut implicitnho flushovn zru bufferovn vstupu, a aktuln obsah
     vstupnch buffer se odele jako pi voln
     <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
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:
-->