$Web Parm Num Line: Difference between revisions

From m204wiki
Jump to navigation Jump to search
m (1 revision)
 
(19 intermediate revisions by 3 users not shown)
Line 1: Line 1:
{{DISPLAYTITLE:$Web_Parm_Num_Line}}
{{DISPLAYTITLE:$Web_Parm_Num_Line}}
<span class="pageSubtitle"><section begin="desc" />Number form or isindex field<section end="desc" /></span>
<span class="pageSubtitle">Number form or isindex field</span>


<var>$Web_Parm_Num_Line</var> retrieves the number of lines in an isindex or form field. It is especially useful for ''textarea'' input fields. <var>$Web_Num_Line</var> is a short synonym for <var>$Web_Parm_Num_Line</var>.


<var>$Web_Parm_Num_Line</var> takes two arguments and returns either the number of lines in the isindex or form field or a 0 indicating either that there were no lines in the isindex or form field or that some other error has occurred. Possible errors would be the isindex or form field not being found or the function being invoked on a non-web server thread.


$Web_Parm_Num_Line retrieves the number of lines in an isindex or form field. It is especially useful for ''textarea'' input fields. $Web_Num_Line is a short synonym for $Web_Parm_Num_Line.
==Syntax==
==Syntax==
<p class="syntax"><section begin="syntax" /> %STRING = $WEB_[PARM_]NUM_LINE( fieldname, occurrence )
<p class="syntax"><span class="term">%string</span> = $Web_[Parm_]Num_Line( <span class="term">fieldname, occurrence</span> )
<section end="syntax" /></p>
</p>
 


$Web_Parm_Num_Line takes two arguments and returns either the number of lines in the isindex or form field or a 0 indicating either that there were no lines in the isindex or form field or that some other error has occurred. Possible errors would be the isindex or form field not being found or the function being invoked on a non-web server thread.
===Syntax terms===
<table class="syntaxTable">
<table class="syntaxTable">
<tr><th>fieldname</th>
<tr><th>fieldname</th>
<td>The name of the isindex or form field, returned by $Web_Name. Required argument if occurrence not specified, otherwise optional.</td></tr>
<td>The name of the isindex or form field, returned by <var>$Web_Name</var>. Required argument if occurrence not specified, otherwise optional.</td></tr>
<tr><th>occurrence</th>
<tr><th>occurrence</th>
<td>The occurrence number of a isindex or form field, or the occurrence number of the isindex or form field matching 'fieldname', if fieldname is specified. Optional argument if fieldname is specified, otherwise it is required.
<td>The occurrence number of a isindex or form field, or the occurrence number of the isindex or form field matching 'fieldname', if fieldname is specified. Optional argument if fieldname is specified, otherwise it is required.
</td></tr></table>
</td></tr></table>


==Usage notes==
<ul>
<li>A line is considered to be a block of text that is terminated by either an ASCII carriage return (X'0D') or a carriage return followed by a line feed (X'0A'). This is what is ordinarily sent by a browser to mark the end of each line of a textarea input field.
<li><var>$Web_Parm_Num_Line</var> first looks for isindex fields matching the name, then for form fields. <var>$Web_Parm_Num_Line</var> can be used instead of <var>$Web_IsIndex_Parm_Num_Line</var> and <var>[[$Web_Form_Parm_Num_Line]]</var> to make it easy to switch between using "method=GET" and "method=POST" <code><form></code> tags and simply to save typing.
</ul>


 
==Examples==
A line is considered to be a block of text that is terminated by either an ASCII carriage return (X'0D') or a carriage return followed by a line feed (X'0A'). This is what is ordinarily sent by a browser to mark the end of each line of a textarea input field.
 
This example checks if the number of lines returned in a textarea exceeds the size of the array meant to hold the input from the textarea.
This example checks if the number of lines returned in a textarea exceeds the size of the array meant to hold the input from the textarea.
<p class="code">  
<p class="code">  
Line 33: Line 36:
</p>
</p>


 
==See also==
$Web_Parm_Num_Line first looks for isindex fields matching the name, then for form fields. $Web_Parm_Num_Line can be used instead of $Web_IsIndex_Parm_Num_Line and $<var><var>Web_Form_Parm_Num_Line</var>./var> to make it easy to switch between using "method=GET" and "method=POST" <form> tags and simply to save typing.
 
See also:
<ul>
<ul>
 
<li><var>[[$Web_Parm_Line]]</var>
<li>[[$Web_Parm_Line]]  
<li><var>[[$Web_Num]]</var>
<li>[[$Web_Num]]  
<li><var>[[$Web_Name]]</var>
<li>[[$Web_Name]]  
<li><var>[[$Web_Parm_Len]]</var>
<li>[[$Web_Parm_Len]]  
<li><var>[[$Web_Parm]]</var>
<li>[[$Web_Parm]]  
<li><var>[[$Web_Form_Parm_Num_Line]]</var>  
<li>[[$<var>Web_Form_Parm_Num_Line</var>.]
<li><var>[[$Web_IsIndex_Parm_Num_Line]]</var>
<li>[[$Web_IsIndex_Parm_Num_Line]]
</ul>
</ul>




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

Latest revision as of 22:04, 5 June 2013

Number form or isindex field

$Web_Parm_Num_Line retrieves the number of lines in an isindex or form field. It is especially useful for textarea input fields. $Web_Num_Line is a short synonym for $Web_Parm_Num_Line.

$Web_Parm_Num_Line takes two arguments and returns either the number of lines in the isindex or form field or a 0 indicating either that there were no lines in the isindex or form field or that some other error has occurred. Possible errors would be the isindex or form field not being found or the function being invoked on a non-web server thread.

Syntax

%string = $Web_[Parm_]Num_Line( fieldname, occurrence )

Syntax terms

fieldname The name of the isindex or form field, returned by $Web_Name. Required argument if occurrence not specified, otherwise optional.
occurrence The occurrence number of a isindex or form field, or the occurrence number of the isindex or form field matching 'fieldname', if fieldname is specified. Optional argument if fieldname is specified, otherwise it is required.

Usage notes

  • A line is considered to be a block of text that is terminated by either an ASCII carriage return (X'0D') or a carriage return followed by a line feed (X'0A'). This is what is ordinarily sent by a browser to mark the end of each line of a textarea input field.
  • $Web_Parm_Num_Line first looks for isindex fields matching the name, then for form fields. $Web_Parm_Num_Line can be used instead of $Web_IsIndex_Parm_Num_Line and $Web_Form_Parm_Num_Line to make it easy to switch between using "method=GET" and "method=POST" <form> tags and simply to save typing.

Examples

This example checks if the number of lines returned in a textarea exceeds the size of the array meant to hold the input from the textarea.

%LINES = $Web_Parm_Num_Line('COMMENTS') IF %LINES GT %MAXLINES THEN AUDIT 'Maximum lines exceeded for ' WITH - $Web_Hdr_Parm('request') WITH - ' - input will be truncated' %LINES = %MAXLINES END IF

See also