Legato
Legato

GoFiler Legato Script Reference

 

Legato v 1.5b

Application v 5.24b

  

 

Chapter FiveGeneral Functions (continued)

ForceScriptError Function

Overview

The ForceScriptError function sets a processing error and causes the script to unwind.

Syntax/Parameters

Syntax

int = ForceScriptError ( dword code );

Parameters

code

A dword to pass as the error. The value must have the top bit set to indicate an error condition (ERROR_BIT or 0x80000000).

Return Value

Returns an int as ERROR_NONE or a formatted error code on failure.

Remarks 

Forcing an error is processed in the same manner as a runtime error. This can allow the unwind function to be passed an error code or condition or allow for exception testing during debugging.

Since the script will process this as a runtime error, an error will be added to the runtime log. In addition, the ERROR_REPORTED (0x00800000) bit will be set as the code is added to the log.

Related Functions

Platform Support

Go13, Go16, GoFiler Complete, GoFiler Corporate, GoFiler, GoFiler Lite, GoXBRL

Legato IDE, Legato Basic