BinaryProcedureDecode (Stringlist function): Difference between revisions

From m204wiki
Jump to navigation Jump to search
m (see also)
m (longstings and example)
Line 14: Line 14:


==Usage notes==
==Usage notes==
<ul><li>All errors in <var>BinaryProcedureDecode</var> result in request cancellation.<li>This method (along with the <var>[[BinaryProcedureEncode (Stringlist subroutine)|BinaryProcedureEncode]]</var> method) facilitates converting data between a longstring and the format used for storing binary data in procedures by <var class="product">[[Janus Web Server]]</var>. This format is necessary if binary data is to be stored in <var class="product">Model 204</var> procedure files because standard procedure formats are not amenable to storing binary data.<li>The <var>BinaryProcedureDecode</var> method is available in <var class="product">Sirius Mods</var> Version 6.7 and later.</ul>
<ul><li>All errors in <var>BinaryProcedureDecode</var> result in request cancellation.<li>This method (along with the <var>[[BinaryProcedureEncode (Stringlist subroutine)|BinaryProcedureEncode]]</var> method) facilitates converting data between a string and the format used for storing binary data in procedures by <var class="product">[[Janus Web Server]]</var>. This format is necessary if binary data is to be stored in <var class="product">Model 204</var> procedure files because standard procedure formats are not amenable to storing binary data.<li>The <var>BinaryProcedureDecode</var> method is available in <var class="product">Sirius Mods</var> Version 6.7 and later.</ul>


==Examples==
==Examples==
<var>BinaryProcedureDecode</var> converts to a <var>string</var> the contents of a <var>Stringlist</var> that has data in the <var class="product">[[Janus Web Server]]</var> binary procedure encoding. In the following example, a GIF is sent to another web server from a <var class="product">Model 204</var> procedure:
<ol><li><var>BinaryProcedureDecode</var> converts to a string the contents of a <var>Stringlist</var> that has data in the <var class="product">[[Janus Web Server]]</var> binary procedure encoding. In the following example, a GIF is sent to another web server from a <var class="product">Model 204</var> procedure:


<p class="code">%req is object httpRequest
<p class="code">%req is object httpRequest
Line 35: Line 35:
...
...
%resp = %reqost
%resp = %reqost
</p>
</p></ol>


==See also==
==See also==
{{Template:Stringlist:BinaryProcedureDecode footer}}
{{Template:Stringlist:BinaryProcedureDecode footer}}

Revision as of 00:16, 29 January 2011

Convert to String from binary procedure format (Stringlist class)


This method is used to create a string from a Stringlist object that contains data in the format used by Janus Web Server to store binary data in procedures. The BinaryProcedureDecode method accepts no arguments, and returns a string result.

Syntax

%string = sl:BinaryProcedureDecode

Syntax terms

%string This longstring is to contain the data in sl.
sl A Stringlist object.

Usage notes

  • All errors in BinaryProcedureDecode result in request cancellation.
  • This method (along with the BinaryProcedureEncode method) facilitates converting data between a string and the format used for storing binary data in procedures by Janus Web Server. This format is necessary if binary data is to be stored in Model 204 procedure files because standard procedure formats are not amenable to storing binary data.
  • The BinaryProcedureDecode method is available in Sirius Mods Version 6.7 and later.

Examples

  1. BinaryProcedureDecode converts to a string the contents of a Stringlist that has data in the Janus Web Server binary procedure encoding. In the following example, a GIF is sent to another web server from a Model 204 procedure:

    %req is object httpRequest %resp is object httpResponse %gif is longstring %procData is object stringList %rc is float ... %rc = $procopn('MONKEY.GIF', 'IMAGES') %procData = new %procData:appendOpenProcedure %gif = %procData:binaryProcedureDecode %req = new %req:multiPartFormEncoding = true %req:addField('IMAGE', %gif) ... %resp = %reqost

See also