$Web Del Sel: Difference between revisions

From m204wiki
Jump to navigation Jump to search
mNo edit summary
 
(15 intermediate revisions by 3 users not shown)
Line 1: Line 1:
{{DISPLAYTITLE:$Web_Del_Sel}}
{{DISPLAYTITLE:$Web_Del_Sel}}
<span class="pageSubtitle"><section begin="desc" />Delete a global select element<section end="desc" /></span>
<span class="pageSubtitle">Delete a global select element</span>


<var>$Web_Del_Sel</var> deletes a global select element, preventing its further use and freeing any CCATEMP pages used by it. An overview of the $Web_Sel* functions is provided in [[$Web_Selp]].


<var>$Web_Del_Sel</var> is a [[Calling_Sirius_Mods_$functions|callable]] $function, and it can be run from a non-<var class="product">Janus Web Server</var> thread.


$Web_Del_Sel deletes a global select element, preventing its further use and freeing any CCATEMP pages used by it. An overview of the $Web_Sel* functions is provided in [[$Web_Selp]].
==Syntax==
==Syntax==
<p class="syntax"><section begin="syntax" /> %RC = $Web_Del_Sel(global_name)
<p class="syntax"><span class="term">%rc</span> = <span class="literal">$Web_Del_Sel</span>(<span class="term">global_name</span>)
<section end="syntax" /></p>
</p>


===Syntax terms===
<table class="syntaxTable">
<tr><th>%rc</th>
<td>A numeric status code. 0 is always returned.


$Web_Del_Sel is a callable $function (see [[Calling_Sirius_Mods_$functions|Calling Sirius Mods $functions]]), and it can be run from a non-<var class="product">[[Janus Web Server]]</var> thread.
$Web_Del_Sel takes one argument and always returns zero.
<table class="syntaxTable">
<tr><th>global_name</th>
<tr><th>global_name</th>
<td>The name of the global select element to delete. If it has not been saved by $WEB_SAVE_SEL, this routine does nothing.
<td>The name of the global select element to delete. If it has not been saved by <var>$Web_Save_Sel</var>, this routine does nothing.
</td></tr></table>
</td></tr></table>


<table class="syntaxTable">
==Usage notes==
<tr><th>Code</th>
<ul>
<td>Meaning</td></tr>
<li>$Web_Del_Sel will delete a global select element, preventing its further use; an example of this is shown in <var>[[$Web_Selp]]</var>. Other than this, <var>$Web_Del_Sel</var> is not needed to perform any processing supplied by the $WEB_SELx functions; unused global select elements will simply have their contents migrate out of the buffer pool and remain as unused CCATEMP pages.
<tr><th>0</th>
</ul>
<td>This is always returned.</td></tr>
 
</table>
<p class="caption">$WEB_DEL_SEL return codes</p>
 
 
$Web_Del_Sel will delete a global select element, preventing its further use; an example of this is shown in [[$Web_Selp]]. Other than this, $Web_Del_Sel is not needed to perform any processing supplied by the $WEB_SELx functions; unused global select elements will simply have their contents migrate out of the buffer pool and remain as unused CCATEMP pages.


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

Latest revision as of 22:40, 5 June 2013

Delete a global select element

$Web_Del_Sel deletes a global select element, preventing its further use and freeing any CCATEMP pages used by it. An overview of the $Web_Sel* functions is provided in $Web_Selp.

$Web_Del_Sel is a callable $function, and it can be run from a non-Janus Web Server thread.

Syntax

%rc = $Web_Del_Sel(global_name)

Syntax terms

%rc A numeric status code. 0 is always returned.
global_name The name of the global select element to delete. If it has not been saved by $Web_Save_Sel, this routine does nothing.

Usage notes

  • $Web_Del_Sel will delete a global select element, preventing its further use; an example of this is shown in $Web_Selp. Other than this, $Web_Del_Sel is not needed to perform any processing supplied by the $WEB_SELx functions; unused global select elements will simply have their contents migrate out of the buffer pool and remain as unused CCATEMP pages.