Evaluate function and statement (LotusScript® Language)

Execute a IBM® software application macro.


Evaluate ( macro [ , object ] )



A string expression specifying the text of a IBM® software application macro, in the syntax that the product recognizes. Refer to the IBM® software documentation for the correct syntax of the macro.

If the macro text is in a constant or string literal, the IBM® software application needs to do only initial processing of the macro once, at compile time, while variable strings incur that processing each time the macro is evaluated.


Optional. The name of a product object. Refer to the product documentation to determine if the macro requires an object, and what the object is.

Return value

If the IBM® software application macro being executed returns a value, the Evaluate function returns a Variant containing that value. Otherwise, the function does not return a value.