Flow of control in SOUL - Revision history

Dme: /* Loop End statement */

2020-04-10T19:24:35Z

Loop End statement

← Older revision		Revision as of 19:24, 10 April 2020
Line 645:		Line 645:
	</p>		</p>
	<p>In the preceding request, if the date of birth is found to be greater than January 1, 1970, the LOOP statement is immediately ended and processing continues beginning with the PRINT.MSG statement.</p>		<p>In the preceding request, if the date of birth is found to be greater than January 1, 1970, the LOOP statement is immediately ended and processing continues beginning with the PRINT.MSG statement.</p>

			See also the <var>[[Loop Next statement\|Loop Next]]</var> statement.

	===Using branching statements to control processing===		===Using branching statements to control processing===

Dme: /* LOOP END statement */

2020-04-10T19:15:48Z

LOOP END statement

← Older revision		Revision as of 19:15, 10 April 2020
Line 621:		Line 621:
	If there are 100 or fewer Virginia drivers in the file, <var class="product">Model 204</var> prints the number of drivers and then print the name of each driver. If there are more than 100 drivers in the file, <var class="product">Model 204</var> prints only the number of drivers. </p>		If there are 100 or fewer Virginia drivers in the file, <var class="product">Model 204</var> prints the number of drivers and then print the name of each driver. If there are more than 100 drivers in the file, <var class="product">Model 204</var> prints only the number of drivers. </p>

	===LOOP END statement===		===<b id="loopEnd"></b><b id="LOOP END"></b>Loop End statement===
	<p>		<p>
	The ~~LOOP END~~ statement transfers control to the statement immediately following the loop that contains the ~~LOOP END~~ statement. This, in effect, is a jump outside a loop to just beyond its end. </p>		The <var>Loop End</var> statement transfers control to the statement immediately following the loop that contains the <var>Loop End</var> statement. This, in effect, is a jump outside a loop to just beyond its end. </p>

	====Example:====		====Example:====

Dme: Dme moved page Flow of control in User Language to Flow of control in SOUL

2019-01-11T20:03:04Z

Dme moved page Flow of control in User Language to Flow of control in SOUL

← Older revision	Revision as of 20:03, 11 January 2019
(No difference)

Dme: Dme moved page Flow of control in User Language to Flow of control in SOUL

2019-01-11T20:03:04Z

Dme moved page Flow of control in User Language to Flow of control in SOUL

← Older revision	Revision as of 20:03, 11 January 2019
(No difference)

JAL: minor formatting

2018-01-22T17:42:34Z

minor formatting

← Older revision		Revision as of 17:42, 22 January 2018
Line 15:		Line 15:
	===Index loops and repeat loops===		===Index loops and repeat loops===
	<ul>		<ul>
	<li>[[#indexLoops\|Index loops]] allow a series of statements to be repeated using an "index" or "counter" variable which is incremented or decremented over a specified range.		<li>[[#indexLoops\|Index loops]] allow a series of statements to be repeated using an "index" or "counter" variable which is incremented or decremented over a specified range. </li>
	~~<p></p></li>~~

	~~<li><var>[[#repeat\|Repeat]]</var> loops allow a series of statements to be repeated any number of times, with termination of the loop controlled by arbitrary conditions specified in the loop.~~
	~~<p></p>~~</li>

			<li><var>[[#repeat\|Repeat]]</var> loops allow a series of statements to be repeated any number of times, with termination of the loop controlled by arbitrary conditions specified in the loop. </li>
	</ul>		</ul>

	===Subroutines===		===Subroutines===
	<p>		<p>
	~~User Language~~ lets you treat a single set of statements as a simple or complex subroutine which can be called from different locations within a request.</p>		SOUL lets you treat a single set of statements as a simple or complex subroutine which can be called from different locations within a request.</p>
	<p>		<p>
	Subroutines, common elements, and ON units are discussed in [[Subroutines#Subroutines\|Subroutines]].</p>		Subroutines, common elements, and ON units are discussed in [[Subroutines#Subroutines\|Subroutines]].</p>
Line 38:		Line 35:
	<p>		<p>
	The basic format of the IF statement is: </p>		The basic format of the IF statement is: </p>
	<p class="~~code~~">IF <span class="term">expression</span> THEN <span class="term">statements</span>		<p class="syntax">IF <span class="term">expression</span> THEN <span class="term">statements</span>
	</p>		</p>
	<p>		<p>
Line 45:		Line 42:
	===Ending an IF statement===		===Ending an IF statement===
	<p>		<p>
	You must terminate the IF statement with an END IF statement or an END BLOCK statement. </p>		You must terminate the IF statement with an END IF statement or an END BLOCK statement. </p>

	===Specifying multiple conditions===		===Specifying multiple conditions===
Line 55:		Line 52:
	===Using the THEN clause===		===Using the THEN clause===
	<p>		<p>
	You can place the keyword THEN at the end of the last condition or on a new line. Although the THEN keyword is not required, you should always provide it to avoid confusion and the possibility of unexpected results. The statement or statements included in the THEN clause can be any ~~User Language~~ statements, as shown in the following example. </p>		You can place the keyword THEN at the end of the last condition or on a new line. Although the THEN keyword is not required, you should always provide it to avoid confusion and the possibility of unexpected results. The statement or statements included in the THEN clause can be any SOUL statements, as shown in the following example. </p>
	<p class="code">IF POLICY NO EQ 100340		<p class="code">IF POLICY NO EQ 100340
	FULLNAME EQ 'ABBOTT, FRANKLIN G'		FULLNAME EQ 'ABBOTT, FRANKLIN G'
Line 263:		Line 260:
	The value of the field AGE is printed if it falls between 3 and 15 inclusively. If the value of AGE is 20, it is not printed because the comparison subclauses are not both true. </p>		The value of the field AGE is printed if it falls between 3 and 15 inclusively. If the value of AGE is 20, it is not printed because the comparison subclauses are not both true. </p>
	<p>		<p>
	In the following example, the value of the field is printed if either or both of the comparison subclauses are true. Any value greater than 45 is printed as will any value equal to 28. </p>		In the following example, the value of the field is printed if either or both of the comparison subclauses are true. Any value greater than 45 is printed as will any value equal to 28. </p>
	<p class="code">IF AGE GT 45 OR AGE EQ 28 THEN		<p class="code">IF AGE GT 45 OR AGE EQ 28 THEN
	PRINT AGE		PRINT AGE
Line 531:		Line 528:
	====Syntax====		====Syntax====
	<p>		<p>
	The format of the JUMP TO statement is: </p>		The format of the JUMP TO statement is: </p>
	<p class="syntax">JUMP TO <span class="term">label</span>		<p class="syntax">JUMP TO <span class="term">label</span>
	</p>		</p>
Line 863:		Line 860:

	<td>STOP </td>		<td>STOP </td>
	<td>Terminate processing within repeat loops; however, the STOP IF COUNT statement is not permitted. </td>		<td>Terminate processing within repeat loops; however, the STOP IF COUNT statement is not permitted. </td>
	</tr>		</tr>
	</table>		</table>
Line 871:		Line 868:
	===REPEAT WHILE statement===		===REPEAT WHILE statement===
	<p>		<p>
	The REPEAT WHILE statement executes a series of statements, as long as the specified condition is true. The condition is evaluated before each execution of the body of the loop. If the condition is false when the REPEAT WHILE statement is first executed, the statements inside the loop are never executed. </p>		The REPEAT WHILE statement executes a series of statements, as long as the specified condition is true. The condition is evaluated before each execution of the body of the loop. If the condition is false when the REPEAT WHILE statement is first executed, the statements inside the loop are never executed. </p>

	====Syntax====		====Syntax====
Line 879:		Line 876:
	</p>		</p>
	<p>		<p>
	where <i>condition</i> can specify one or more conditions. The conditions must be specified on one logical line. A hyphen is used to note the continuation of the set of conditions (with a logical AND implied at each end-of-line) for a logical line. </p>		where <var class="term">condition</var> can specify one or more conditions. The conditions must be specified on one logical line. A hyphen is used to note the continuation of the set of conditions (with a logical AND implied at each end-of-line) for a logical line. </p>

	====Example 1====		====Example 1====
Line 891:		Line 888:
	====Example 2====		====Example 2====
	<p>		<p>
	This example illustrates the use of the REPEAT WHILE statement: </p>		This example illustrates the use of the REPEAT WHILE statement: </p>
	<p class="code"> .		<p class="code"> .
	.		.
Line 983:		Line 980:
	</p>		</p>
	<p>		<p>
	You can have a statement within the body of the loop to change the value of a %variable specified as the iteration count. However, such a change has no effect on the number of times the loop is executed because the iteration count is examined only once, prior to the first iteration. </p>		You can have a statement within the body of the loop to change the value of a %variable specified as the iteration count. However, such a change has no effect on the number of times the loop is executed because the iteration count is examined only once, prior to the first iteration. </p>

	===REPEAT FOREVER statement===		===REPEAT FOREVER statement===

Dme: /* Index loops and repeat loops */

2018-01-18T11:01:23Z

Index loops and repeat loops

← Older revision		Revision as of 11:01, 18 January 2018
Line 14:		Line 14:

	===Index loops and repeat loops===		===Index loops and repeat loops===
	<p>		<ul>
	~~This topic also introduces special loop types, called index loops and~~ repeat loops~~, that~~ allow a series of statements to be repeated ~~a specified~~ number of times.</p>		<li>[[#indexLoops\|Index loops]] allow a series of statements to be repeated using an "index" or "counter" variable which is incremented or decremented over a specified range.
			<p></p></li>

			<li><var>[[#repeat\|Repeat]]</var> loops allow a series of statements to be repeated any number of times, with termination of the loop controlled by arbitrary conditions specified in the loop.
			<p></p></li>

			</ul>

	===Subroutines===		===Subroutines===
	<p>		<p>

Dme: /* Repeat loops */

2018-01-18T10:57:18Z

Repeat loops

← Older revision		Revision as of 10:57, 18 January 2018
Line 801:		Line 801:
	</p>		</p>

	==Repeat loops==		==<b id="repeat"></b>Repeat loops==
	<p>		<p>
	As discussed previously, you can use the index loop wherever you want to execute a set of statements a specific number of times. However, if the series of statements to be executed either does not need a number specification or if the times of execution occur in a non-uniform manner, you can use a repeat loop. </p>		As discussed previously, you can use the index loop wherever you want to execute a set of statements a specific number of times. However, if the series of statements to be executed either does not need a number specification or if the times of execution occur in a non-uniform manner, you can use a repeat loop. </p>

Dme: /* Transferring control to another point */

2018-01-18T10:29:34Z

Transferring control to another point

← Older revision		Revision as of 10:29, 18 January 2018
Line 4:		Line 4:
	===Transferring control to another point===		===Transferring control to another point===
	<p>		<p>
	~~User Language~~ statements are normally executed in the sequence in which they are written. ~~This topic describes special~~ statements ~~that~~ can be used to transfer control to another point in the request~~. </p>~~		SOUL statements are normally executed in the sequence in which they are written. The following statements can be used to transfer control to another point in the request:</p>
	~~<p>~~
	~~These transfer control statements include~~:</p>
	<ul>		<ul>
	<li><var>[[#if\|If]]</var> statement</li>		<li><var>[[#if\|If]]</var> statement</li>

Dme: /* Transferring control to another point */

2018-01-18T10:26:48Z

Transferring control to another point

← Older revision		Revision as of 10:26, 18 January 2018
Line 8:		Line 8:
	These transfer control statements include:</p>		These transfer control statements include:</p>
	<ul>		<ul>
	<li>IF statement</li>		<li><var>[[#if\|If]]</var> statement</li>
	<li>JUMP TO statement</li>		<li>JUMP TO statement</li>
	<li>STOP statement</li>		<li>STOP statement</li>
Line 14:		Line 14:
	<li>LOOP END statement</li>		<li>LOOP END statement</li>
	</ul>		</ul>

	===Index loops and repeat loops===		===Index loops and repeat loops===
	<p>		<p>

Dme: /* Index loops */

2017-11-17T05:31:46Z

Index loops

← Older revision		Revision as of 05:31, 17 November 2017
Line 705:		Line 705:
	</p>		</p>

	==<b id="indexLoops"></b>Index loops==		==<b id="indexLoops"></b>Index loops - For <i>%var</i> From .. To .. By ..==
	<p>		<p>
	The index loop statement executes a series of statements for each element of an array, for particular dimensions of the array, or for particular elements of the array. In addition to being used with arrays, index loops can be used any place wherever a set of statements is to be executed a number of times. If the loop is controlled by a number rather than by a value or a FOR loop, an index loop can be used. </p>		The index loop statement executes a series of statements for each element of an array, for particular dimensions of the array, or for particular elements of the array. In addition to being used with arrays, index loops can be used any place wherever a set of statements is to be executed a number of times. If the loop is controlled by a number rather than by a value or a FOR loop, an index loop can be used. </p>