$include

Synopsis

$include_vfile

Description

$include includes a V file into the current object.

vfile can be a full or relative pathname. If it is a relative pathname, AVS/Express looks for the file in the directories specified by the environment variable $XP_VPATH. $XP_VPATH by default includes the v directories in your $XP_PATH. It also includes the start-up directory. To print the value of $XP_VPATH (along with other paths), specify the "-vb paths" command-line option at start-up.

This command does not resolve any forward references that might have been generated. This means that errors may be hidden and also that connections may not be fully realized. If you are entering this command interactively, you should use the $resolve afterwards to flush out any hidden errors and to resolve connections.

Examples

For example, assume that myfile.v contains the following V statements:

float y;
float z;

You include myfile.v into an object called grp1:

OM(SingleWindowApp) -> group grp1 {
OM(grp1) -> int x;
OM(grp1) -> $include /home/vdir/myfile.v
OM(grp1) -> $resolve
OM(grp1) -> };
OM(SingleWindowApp) -> $print grp1
group grp1 {
int x;
float y;
float z;
};