$Web Flush: Difference between revisions

From m204wiki
Jump to navigation Jump to search
(Created page with "{{DISPLAYTITLE:$Web_Flush}} <span class="pageSubtitle"><section begin="desc" />Clear contents of Web response buffer<section end="desc" /></span> $Web_Flush clears the content...")
 
(Automatically generated page update)
 
(10 intermediate revisions by 3 users not shown)
Line 1: Line 1:
{{DISPLAYTITLE:$Web_Flush}}
{{DISPLAYTITLE:$Web_Flush}}
<span class="pageSubtitle"><section begin="desc" />Clear contents of Web response buffer<section end="desc" /></span>
<span class="pageSubtitle">Clear contents of Web response buffer</span>


<var>$Web_Flush</var> clears the contents of the client buffer.


<var>$Web_Flush</var> takes no arguments and returns a numeric status code. It is a [[Calling_Sirius_Mods_$functions|callable]] $function.


$Web_Flush clears the contents of the client buffer.
==Syntax==
==Syntax==
<p class="syntax"><section begin="syntax" /> %RC = $Web_Flush
<p class="syntax"><span class="term">%rc</span> <span class="literal">= $Web_Flush</span>
<section end="syntax" /></p>
</p>


 
===Syntax terms===
$Web_Flush takes no arguments and returns a numeric status code. It is a callable $function (see [[Calling_Sirius_Mods_$functions|Calling Sirius Mods $functions]]).
<table class="syntaxTable">
<tr><th>%rc</th>
<td>A numeric status code:
<table class="syntaxTable">
<table class="syntaxTable">
<tr><th>Code</th>
<tr><th>Code</th>
<td>Meaning</td></tr>
<th>Meaning</th></tr>
<tr><th>0</th>
<tr><th>0</th>
<td>Completed successfully</td></tr>
<td>Completed successfully</td></tr>
<tr><th>-1</th>
<tr><th>-1</th>
<td>Not a web thread</td></tr>
<td>Not a web thread</td></tr>
</table>
</table>
<p class="caption">$WEB_FLUSH return codes</p>
</td></tr>
</table>


==Usage notes==
<ul>
<li>Everything sent to a client is buffered and sent at the completion of the request. This allows lines to be put to the client buffer (CCATEMP) from many points in the application, and the send to be performed once. <var>$Web_Flush</var> clears the client buffer and allows the application to begin building the buffer over again from scratch.


Everything sent to a client is buffered and sent at the completion of the request. This allows lines to be put to the client buffer (CCATEMP) from many points in the application, and the send to be performed once. $Web_Flush clears the client buffer and allows the application to begin building the buffer over again from scratch.  
<li>Use <var>$Web_Flush</var> when the application detects an error and needs to change the sent content.
</ul>


Use $Web_Flush when the application detects an error and needs to change the sent content.
==Examples==
<p class="code"> ON FIND CONFLICT
<p class="code">ON FIND CONFLICT
   
   
%X = $Web_Flush
%x = $Web_Flush
%X = $Web_Type('text/HTML')
%x = $Web_Type('text/HTML')
%X = $Web_ProcSend( 'WEBFILE', 'OFC.HTML' )
%x = $Web_ProcSend( 'WEBFILE', 'OFC.HTML' )
STOP
STOP
   
   
END ON
END ON
</p>
</p>
<p>
In the above example, <var>$Web_Flush</var> is used in an <var>ON</var> unit to clear any information in the client buffer before the content type is set and the static HTML in procedure <code>OFC.HTML</code> is sent to the client. </p>


 
==See also==
In the above example, $Web_Flush is used in an ON unit to clear any information in the client buffer before the content type is set and the static HTML in procedure 'OFC.HTML' is sent to the client.
<ul>
 
<li><var>[[$Web_Off]]</var> and <var>[[$Web_On]]</var>
See also [[$Web_Off]] and [[$Web_On]].
</ul>


[[Category:Janus Web Server $functions|$Web_Flush]]
[[Category:Janus Web Server $functions|$Web_Flush]]

Latest revision as of 15:50, 9 April 2013

Clear contents of Web response buffer

$Web_Flush clears the contents of the client buffer.

$Web_Flush takes no arguments and returns a numeric status code. It is a callable $function.

Syntax

%rc = $Web_Flush

Syntax terms

%rc A numeric status code:
Code Meaning
0 Completed successfully
-1 Not a web thread

Usage notes

  • Everything sent to a client is buffered and sent at the completion of the request. This allows lines to be put to the client buffer (CCATEMP) from many points in the application, and the send to be performed once. $Web_Flush clears the client buffer and allows the application to begin building the buffer over again from scratch.
  • Use $Web_Flush when the application detects an error and needs to change the sent content.

Examples

ON FIND CONFLICT %x = $Web_Flush %x = $Web_Type('text/HTML') %x = $Web_ProcSend( 'WEBFILE', 'OFC.HTML' ) STOP END ON

In the above example, $Web_Flush is used in an ON unit to clear any information in the client buffer before the content type is set and the static HTML in procedure OFC.HTML is sent to the client.

See also