Click or drag to resize

VoDbEval Function

Evaluate a code block for each record that matches a specified scope and/or condition.

Namespace:  XSharp.RT
Assembly:  XSharp.RT (in XSharp.RT.dll) Version: 2.0
Syntax
 FUNCTION VoDbEval(
	uBlock AS USUAL,
	uCobFor AS USUAL,
	uCobWhile AS USUAL,
	nNext AS USUAL,
	nRecno AS USUAL,
	lRest AS LOGIC
) AS LOGIC

Parameters

uBlock
Type: USUAL
The code block to execute for each record that matches the scope and conditions.
uCobFor
Type: USUAL
A code block that defines a condition that each record within the scope must meet in order to be processed.
uCobWhile
Type: USUAL
A code block that defines another condition that each record must meet in order to be processed. As soon as a record is encountered that causes the condition to fail, the operation terminates. If no scope is specified, cbWhileCondition changes the default scope to lRest.
nNext
Type: USUAL
nRecno
Type: USUAL
The number of the record to process.
lRest
Type: Boolean
TRUE processes only records from the current record to end-of-file. FALSE processes all records.

Return Value

Type: Boolean
TRUE if successful; otherwise, FALSE.
Remarks
By default, Eval() operates on the currently selected work area. It will operate on an unselected work area if you specify it as part of an aliased expression. On each iteration, Eval() evaluates the specified code block. All records within the scope or matching the condition are processed until end-of-file is reached. Eval() can be used as a primitive for the construction of commands that process database files. In fact, many of the database processing commands are created using Eval().

Tip Tip
The difference between VoDbEval and CoreDb.Eval is that VoDbEval takes USUAL parameters
See Also