Laura: /* Syntax */

2014-05-05T17:12:33Z

Syntax

← Older revision		Revision as of 17:12, 5 May 2014
Line 16:		Line 16:

	===Syntax===		===Syntax===
	READ {Mat <array name>\|<variable name>}[,...] [<error condition> <line ref>][,...]		READ {[[Mat]] <[[array name]]>\|<[[variable name]]>}[,...] [<[[error condition]]> <[[line ref]]>][,...]

	[[Image:Readdata.png]]		[[Image:Readdata.png]]

Laura: /* Syntax */

2014-04-28T16:54:17Z

Syntax

← Older revision		Revision as of 16:54, 28 April 2014
Line 16:		Line 16:

	===Syntax===		===Syntax===
			READ {Mat <array name>\|<variable name>}[,...] [<error condition> <line ref>][,...]

	[[Image:Readdata.png]]		[[Image:Readdata.png]]

Laura: Created page with "The '''Read''' (REA) data statement assigns values to variables from internal lists created by DATA statements. ===Comments and Examples=== READ statements automa..."

2013-01-31T21:57:13Z

Created page with "The '''Read''' (REA) data statement assigns values to variables from internal lists created by DATA statements. ===Comments and Examples=== READ statements automa..."

New page

The '''Read''' (REA) data [[statement]] assigns values to [[variables]] from internal lists created by [[DATA]] statements.

===Comments and Examples===
READ statements automatically match themselves up to [[DATA]] statements. A program's first READ statement variable is set to its first DATA statement value; the second READ statement variable is set to the second DATA statement value; and so on. When a READ statement has more variables than a DATA statement has values, Business Rules searches for the program's next DATA statement. In the following example, the execution of line 55 assigns 2 to T, 4 to F, 8 to E, 16 to S, 32 to X and 64 to M:

00045 DATA 2, 4, 8
00055 READ T, F, E, S, X, M
00065 DATA 16, 32, 64, 128, 512

The following example shows how the [[CNT]] [[internal function]] can be used to determine how many variables have been read:

00010 DIM A (20)
00020 DATA 1,1,1,1,1
00030 READ MAT A EOF 40
00040 MAT A (CNT)

===Syntax===

[[Image:Readdata.png]]

===Default===
# Interrupt the program if an error occurs and [[ON error]] is not active.

===Parameters===
The "MAT array-name" and "var-name" parameters represent the list of variables to be assigned to DATA statement values. Multiple specifications must be separated with commas.

READ's optional "error cond line-ref" tells the system what to do when an error occurs. See [[Error Conditions]] for more information.

===Technical Considerations===
# Relevant error conditions are: [[CONV]], [[EOF]], [[ERROR]], [[EXIT]], and [[SOFLOW]].
# When there are more variables in a program's READ statements than there are values in its DATA statements, Business Rules! returns error code [[0054]] (out of data for READ). This error can be trapped with the EOF error condition.
# When a program's DATA statements contain more values than its READ statements contain variables, no error will occur. The extra values are available for the next READ statement.
# Array references in a data-item list are assigned values by row/column. READ assigns values all the way across a row before it moves on to the next row.

<noinclude>
[[Category:Internal Data Table Statements]]
[[Category:Statements]]
</noinclude>

Read Data - Revision history

Laura: /* Syntax */

Laura: /* Syntax */

Laura: Created page with "The '''Read''' (REA) data statement assigns values to variables from internal lists created by DATA statements. ===Comments and Examples=== READ statements automa..."