error

 

 

Description

The error function writes the value of the expressions {exp} to the Analytic Information Server Console Window, and returns to the top level Analytic Information Server event loop with the specified error string {errorStr}. If no Console Window is open, Lisp will open a Console Window. In Lisp, the error function always terminates the current process, unless enclosed inside an errorTrap function call (see errorTrap). Furthermore, the error string {errorStr} argument will always be truncated to 12 characters and will be displayed as an error constant which is the error text preceded by an exclamation (!) and terminating with an exclamation (!).

When to use

The error function is used to exit out of a function to the top level (usually to the console) and display an error message.

 

Syntax

(error errorStr exp ...)



Name Description AIS Types
errorStr The Error value !errorStr!String
exp An expression, which will be evaluated, and the result displayed on the console.---


Returns:

Return value is the !errorStr! constructed as an Analytic Information Server Error value. The error function also evaluates exp and displays the result on the console.

 

Examples

Here are a number of links to Lambda coding examples which contain this instruction in various use cases.

Example_Error_error_001

The error function assigns an error string to the error type.

 

Argument Types

Here are the links to the data types of the function arguments.

Error

Here are also a number of links to functions having arguments with any of these data types.

errorTrap(Error) error(Error) isIdentical(BitVector) isIdentical(Boolean)
isIdentical(Brick) isIdentical(Character) isIdentical(Complex) isIdentical(Date)
isIdentical(Dictionary) isIdentical(Directory) isIdentical(Error) isIdentical(FltVector)
isIdentical(Function) isIdentical(IntVector) isIdentical(List) isIdentical(Matrix)
isIdentical(NumMatrix) isIdentical(NumVector) isIdentical(Number) isIdentical(ObjVector)
isIdentical(ObjectRepository) isIdentical(Pair) isIdentical(PcodeVector) isIdentical(ShortVector)
isIdentical(Structure) isIdentical(Vector) isIdentical(Void) string(Complex)
string(String)

How do I contact the AIS team?

You can always talk with the AIS at aiserver.sourceforge.net.