AppendOpenProcedure (Stringlist function): Difference between revisions

From m204wiki
Jump to navigation Jump to search
m (Insert from where reading starts under numlines)
mNo edit summary
Line 1: Line 1:
{{Template:Stringlist:AppendOpenProcedure subtitle}}
{{Template:Stringlist:AppendOpenProcedure subtitle}}


This callable method adds lines to the end of a <var>Stringlist</var> from a procedure opened with <var>$procopn</var>.
This callable method adds lines to the end of a <var>Stringlist</var> from a procedure opened with <var>$procOpn</var>.


==Syntax==
==Syntax==

Revision as of 23:21, 25 January 2011

Add lines from procedure to Stringlist (Stringlist class)


This callable method adds lines to the end of a Stringlist from a procedure opened with $procOpn.

Syntax

[%rc =] sl:AppendOpenProcedure[( [numLines], [seqIncrement])]

Syntax terms

%rc An, optional, numeric variable that is set to zero if the function is a success.
sl A Stringlist object.
numLines The number of lines to be read. If this optional argument is not provided, reading commences from the start of the input procedure if no lines have been read from it, yet; or continues from after the last line read, if data has already been read from the procedure; and continues to the end of that procedure.
seqIncrement A sequence number increment for 8-byte sequence numbers to be placed in front of each line in the output Stringlist. This sequence number indicates both the starting sequence number and the sequence number increment. If this parameter is not provided, no sequence numbers are placed in front of the input lines.

Usage notes

All errors in AppendOpenProcedure result in request cancellation.

The seqIncrement argument to AppendOpenProcedure is intended for use in conjunction with the Update and Compare methods.

Examples

In the following example of the AppendOpenProcedure method, procedure SUTPENS_HUNDRED in file JACKSON contains this request:

b for %i from 1 to 10 print %i end for end

The program example follows:

b %list is object stringList %rc is float %list = new %rc = $procopn('SUTPENS_HUNDRED', 'JACKSON') %list:appendOpenProcedure(,5000) %list:print end

The program result is a print of these lines:

00005000b 00010000 for %i from 1 to 10 00015000 print %i 00020000 end for 00025000end