BinaryProcedureDecode (Stringlist function)

From m204wiki
Revision as of 21:07, 17 January 2011 by Alex (talk | contribs) (→‎Syntax terms)
Jump to navigation Jump to search

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 (Stringlist subroutine)) facilitates converting data in a longstring into 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

BinaryProcedureDecode converts to a longstring 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