AppendOpenProcedure (Stringlist function): Difference between revisions
Jump to navigation
Jump to search
m (Apply Dave's comments) |
|||
| (14 intermediate revisions by 5 users not shown) | |||
| 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>$ | This [[Notation conventions for methods#Callable functions|callable]] method adds lines to the end of a <var>Stringlist</var> from a procedure opened with <var>[[$ProcOpn]]</var>. | ||
==Syntax== | ==Syntax== | ||
| Line 12: | Line 12: | ||
<td>A <var>Stringlist</var> object.</td></tr> | <td>A <var>Stringlist</var> object.</td></tr> | ||
<tr><th>numLines</th> | <tr><th>numLines</th> | ||
<td>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 | <td>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.</td></tr> | ||
<tr><th>seqIncrement</th> | <tr><th>seqIncrement</th> | ||
<td>A sequence number increment for 8-byte sequence numbers to be placed in front of each line in the output <var>Stringlist</var>. 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 output lines.</td></tr> | <td>A sequence number increment for 8-byte sequence numbers to be placed in front of each line in the output <var>Stringlist</var>. 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 output lines.</td></tr> | ||
| Line 18: | Line 18: | ||
==Usage notes== | ==Usage notes== | ||
All errors in <var>AppendOpenProcedure</var> result in request cancellation. | <ul><li>All errors in <var>AppendOpenProcedure</var> result in request cancellation. | ||
<li>The <var class="term">seqIncrement</var> argument to <var>AppendOpenProcedure</var> is intended for use in conjunction with the <var>[[Update (Stringlist function)|Update]]</var> and <var>[[Compare (Stringlist function)|Compare]]</var> methods.</ul> | |||
The <var class="term">seqIncrement</var> argument to <var>AppendOpenProcedure</var> is intended for use in conjunction with the <var>[[Update (Stringlist function)|Update]]</var> and <var>[[Compare (Stringlist function)|Compare]]</var> methods. | |||
==Examples== | ==Examples== | ||
In the following example of the <var>AppendOpenProcedure</var> method, procedure <code>SUTPENS_HUNDRED</code> in file <code>JACKSON</code> contains this request: | |||
In the following example of the <var>AppendOpenProcedure</var> method, procedure SUTPENS_HUNDRED in file JACKSON contains this request: | <p class="code">begin | ||
for %i from 1 to 10 | |||
<p class="code"> | print %i | ||
end for | |||
end | end | ||
</p> | </p> | ||
| Line 36: | Line 32: | ||
The program example follows: | The program example follows: | ||
<p class="code"> | <p class="code">begin | ||
%list is object stringlist | |||
%rc is float | |||
%list is object | |||
%rc is float | %list = new | ||
%list = new | %rc = $procopn('SUTPENS_HUNDRED', 'JACKSON') | ||
%list:appendOpenProcedure(,5000) | |||
%rc = $procopn('SUTPENS_HUNDRED', 'JACKSON') | |||
%list:appendOpenProcedure(,5000) | %list:print | ||
%list:print | |||
end | end | ||
</p> | </p> | ||
| Line 54: | Line 47: | ||
The program result is a print of these lines: | The program result is a print of these lines: | ||
<p class="output"> | <p class="output">00005000begin | ||
00010000 for %i from 1 to 10 | 00010000 for %i from 1 to 10 | ||
00015000 print %i | 00015000 print %i | ||
| Line 62: | Line 54: | ||
</p> | </p> | ||
==See also== | |||
{{Template:Stringlist:AppendOpenProcedure footer}} | |||
Latest revision as of 19:17, 11 June 2014
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 output 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:
begin for %i from 1 to 10 print %i end for end
The program example follows:
begin %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:
00005000begin 00010000 for %i from 1 to 10 00015000 print %i 00020000 end for 00025000end