Alex: Created page with "{{DISPLAYTITLE:$Web_Form_Parm_Binary}} Value of form field to longstring `$Web_Form_Parm_Binary` retrieves the value of an HTML for..."

2020-02-20T02:09:37Z

Created page with "{{DISPLAYTITLE:$Web_Form_Parm_Binary}} <span class="pageSubtitle">Value of form field to longstring</span> <var>$Web_Form_Parm_Binary</var> retrieves the value of an HTML for..."

New page

{{DISPLAYTITLE:$Web_Form_Parm_Binary}}
<span class="pageSubtitle">Value of form field to longstring</span>

<var>$Web_Form_Parm_Binary</var> retrieves the value of an HTML form field as a [[Longstrings|longstring]]. Unlike [[$Web_Form_Parm_Lstr]], it returns the value of the form parameter, exactly as sent by the client, rather than translated to ASCII.

<var>$Web_Form_Parm_Binary</var> takes two arguments and returns a longstring or null for any error condition.

==Syntax==
<p class="syntax"><span class="term">%string</span> = <span class="literal">$Web_Form_Parm_Binary</span>( <span class="term">name</span>, [<span class="term">occurrence</span>] )
</p>

===Syntax terms===
<table class="syntaxTable">
<tr><th>name</th>
<td>The name of the form field, returned by <var>$Web_Form_Name</var>. Required argument if occurrence is not specified, otherwise optional.</td></tr>
<tr><th>occurrence</th>
<td>The occurrence number of a form field, or the occurrence number of the form field matching ''name'', if ''name'' is specified. This is an optional argument if ''name'' is specified; otherwise it is required.
</td></tr></table>

==Usage notes==
<ul>
<li>The most likely use for <var>$Web_Form_Parm_Binary</var> is to access the value of form fields with contents that are UTF-8 rather than plain ASCII and so are not amenable to simple ASCII to EBCDIC translation. As such, a common uasge for <var>$Web_Form_Parm_Binary</var> is to apply the [[Utf8ToUnicode (String function)|Utf8ToUnicode]] function against its result:
<p class="code">%unicode is unicode
...
%unicode = $web_form_parm_binary("XML"):Utf8ToUnicode
</p></li>
</ul>

==Examples==
If you have an HTML form defined as follows:

<p class="code"> <form method="POST" action="myUrl">
<br>Foo:<input type="text" name="foo" size="20">
<br>Bar:<input type="text" name="bar" size="20">
<br><input type="submit">
</form>
</p>

The following will retrieve the values of the <code>Foo</code> and <code>Bar</code> fields into unicode strings called <code>%foo</code> and<code>%bar</code>.

<p class="code">%foo = $web_form_parm_lstr('FOO'):utf8ToUnicode
%bar = $web_form_parm_lstr('BAR'):utf8ToUnicode
</p>

==See also==
<ul>
<li><var>[[$Web_Form_Parm]]</var>
<li><var>[[$Web_Form_Name]]</var>
<li><var>[[$Web_Form_Parm_Line]]</var>
<li><var>[[$Web_Form_Parm_Lstr]]</var>
</ul>

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

$Web Form Parm Binary - Revision history

Alex: Created page with "{{DISPLAYTITLE:$Web_Form_Parm_Binary}} Value of form field to longstring $Web_Form_Parm_Binary retrieves the value of an HTML for..."

Alex: Created page with "{{DISPLAYTITLE:$Web_Form_Parm_Binary}} Value of form field to longstring `$Web_Form_Parm_Binary` retrieves the value of an HTML for..."