ICAM Virtual Machine V19 - Kxcad.net

Virtual Machine Reference, Model Customization
The Macro Language, Fundamentals of the Macro Language
tion operator, then the logical “and” followed lastly by the logical “or”. The following are
equivalent:
A.LT.B.OR..NOT.C.GT.D.AND.E.EQ.F
(A.LT.B).OR.((.NOT.(C.GT.D)).AND.(E.EQ.F))
ad&&e==f
(ad))&&(e==f))
Function Calls
The macro language provides a wide variety of functions to simplify the task of writing macros.
Functions accept zero or more arguments as input and return a value of a specific type (e.g., real
or logical), although there are a few functions that can return various result types. See
“Simulation Macro Functions” on page 152 for a description of available VM specific macro
functions, their input arguments and return values.
The general syntax of a function call is as follows:
$Ffunction_name( [argument [,argument...]] )
The order in which the arguments are specified is very important. Some functions require no
arguments, but the parentheses must still be specified. For example, the $FGETCWD() function
(always called without parameters) returns the file path of the current working directory.
A function can be used in an expression anywhere a value is permitted, if the function returns a
data type consistent with the rest of the expression. Functions can be called as arguments to other
functions.
External Functions
The macro processor supports the use of global user functions written in C ++ that have been
compiled and linked into a shareable library (e.g., a .dll file on Windows or a .so file on UNIX).
Sample source files, an API development kit and HTML documentation can all be found in the
installation “Samples/SDK” folder.
External functions must be defined before they can be used, so that the macro processor will
know the name of the function and the number and data types of the parameters that are passed
to the function. The declaration syntax is as follows:
DECLAR / EXTERN,FUNCTION,'filename'[,type],name([type[,...])
The filename string specifies the name of the shareable library. If the filename does not include
the file type (e.g., .dll). then the default file type for the current Windows or UNIX architecture
will be used. If the filename does not include a file path, or if the file path is relative, then the
default path is the installation “bin/system-type” folder. On UNIX systems, the file name is case
sensitive.
The name defines the name of the function. External function names must always start with an
alphabetic character. The remaining characters can be any combination of letters, digits and the
ICAM Technologies Corporation – Proprietary 131