void = RaiseError(sErrorMessage, bAbortScript)
This void function takes 2 parameters :
This is the text that will appear in the error message, whether it is simply a run-time message, or it causes the script to abort.
If the value of bAbortScript is set to false then the failure of this assertion will simply abort the current macro and generate a run-time message which will be displayed in the messages window during diary generation. If the value of bAbortScript is set to true then the failure of this assertion will abort the current script and display a modal message with the context of the error (see example below).
The RaiseError function is useful when you know that the macro execution reaching a certain position is definitely an error (no need to check if a condition is true as in the case of the Assert function).
// do weekday stuff
// do weekend stuff
RaiseError('nWeekdayNumber is not in range of 1-7', true)
bAbortScript = false
The following call to RaiseError with bAbortScript being false,
RaiseError('nWeekdayNumber is not in range of 1-7', false)
would then add the following messages to the diary generation messages dialog, without interrupting the script execution.
bAbortScript = true
The following call to RaiseError with bAbortScript being true,
Assert(nInputValue in [1..7], 'Weekday is not in range of 1-7', true)
would then immediately display the following dialog, with detailed information about the context of the message, and then abort script execution.
If you only want to verify that a unique basic assumption is true, then an alternative is to use the Assert function, instead, or if you want a run-time message to be generated, without causing any error condition, you may want to use the LogMessage function.