Invalid

(Engine-Level Function)

Description: Return Invalid Value. This function always returns an invalid value.
Returns: Invalid
Function Groups: Logic Control,  Variable
Usage: Script or steady state.
Related to: Valid
Format: Invalid()
Parameters:

None

Comments: This function is useful to invalidate data that are found to be incorrect, or to disable statements or functions that will not execute with invalid parameters.

Examples:

  X = Valid(Invalid());

This will set X to 0.

Another example of this function's usefulness follows:

Main [
  If !Valid(aa);
  [ 
    a = Scale(Rand(), 0, 1, -1000, 1000); 
    ... 
  ] 
  If Valid(a);
  [ 
    ... 
    a = Invalid(); 
  ] 
]

By toggling between a valid and an invalid value, you can ensure that the two scripts in Main will take turns executing. It is not possible for a race condition to occur.