$resolve

Synopsis

$resolve [object]

Description

$resolve resolves all forward references and prints an error message if it is unable to resolve a forward reference.

Forward reference

A forward reference is a reference to an object that has not yet been defined. AVS/Express allows forward references. For example, x has a forward reference to y:

int x => y;
int y = 3;

Until y is defined, x's value is null.

Because forward references are allowed, AVS/Express does not print an error message if you reference an object but misspell its name. $resolve is useful for catching such errors. You particularly need to use the $resolve command after using the $include command.

Examples

OM(SingleWindowApp) -> int x => y;
OM(SingleWindowApp) -> $resolve
SingleWindowApp is not resolved
--- Error detected in: module: resolve ---
0-> can't resolve value: `y' for element: Root.Applications.SingleWindowApp.x
1-> can't resolve element: SingleWindowApp
--------------------------------------------------
OM(SingleWindowApp) -> $int x
int value is not set
OM(SingleWindowApp) -> int y = 3;
OM(SingleWindowApp) -> $resolve
SingleWindowApp is now resolved
OM(SingleWindowApp) -> $int x
3

In this example, since no argument was supplied to the $resolve command, it resolved the current object which was SingleWindowApp. Since this object contained some unresolved references, the object SingleWindowApp itself is still considered to be unresolved after the operation.