ENVIRONMENT ... END ENVIRONMENT
Ada Test Script Language
Purpose
The ENVIRONMENT instruction defines a test environment declaration, that is, a default set of test specifications.
Syntax
ENVIRONMENT <name>
END ENVIRONMENT
<name> is a mandatory identifier that provides a unique environment name.
Description
The test environment defines a general context. Variables which are declared within a context can be overwritten by a TEST statement.
The END ENVIRONMENT instruction marks the end of an environment declaration.
<name> specifies an environment name that is referenced in the USE instruction.
An environment must be defined after the BEGIN instruction.
Each environment is visible in the block in which it has been declared and in any blocks included in this block, after its declaration.
An environment can only contain VAR, ARRAY, STR, FORMAT or STUB instructions and conditional generation instructions. If it is empty, a warning message is generated.
An environment is activated by the USE instruction that defines its scope and its priority. ENVIRONMENT blocks are executed in the reverse order of their respective USE instruction.
Note If the USE instruction follows directly the ENVIRONMENT block, the first occurrence of the ENVIRONEMENT overrides the later, or local ones.
After generating the initializations and the tests of an ELEMENT block, visible environments are included in order of priority, at every END ELEMENT instruction, in order to complete the initializations and tests.
The scope of an ENVIRONMENT block is important insofar as only "visible" environment blocks apply, and use clauses can be out of scope.
Example
ENVIRONMENT compute_histo
VAR x1, init = 0, ev = init
VAR x2, init = SIZE_IMAGE-1, ev = init
ARRAY image, init = 0, ev = init
END ENVIRONMENT
Related Topics