Function & Argument Type(s)

Description

        Examples

cast

type1, type2

Return Type: type1

Return the second argument converted to the type of the first, or throw an exception if the conversion is invalid.

 cast(int,double)

constants         

none

Return Type: data structure

Return a data structure identifying all the globally defined constants in the expression language.

 constants( )

filter

function, {type}

Return Type: {type}  

Extract a sub-array consisting of all of the elements of an array for which the given predicate function returns true.

filter

function, {type}, int

Return Type: {type}

Extract a sub-array with a limited size consisting of all of the elements of an array for which the given predicate function returns true.

findFile

string

Return Type: string

Given a file name relative to the user directory, current directory, or classpath, return the absolute file name of the first match, or return the name unchanged if no match is found.

findFile("doc")

="C:\VisualSim\VS_AR\doc"

freeMemory

none

Return Type: long

Return the approximate number of bytes available for future memory allocation.

 a = freeMemory()

   = 252264992L

iterate

function, int, type

Return Type: {type}

Return an array that results from first applying the specified function to the third argument, then applying it to the result of that application, and repeating to get an array whose length is given by the second argument.

map

function, {type}

Return Type: {type}

Return an array that results from applying the specified function to the elements of the specified array.

property

string

Return Type: string

Return a system property with the specified name from the environment, or an empty string if there is none. Some useful properties are java.version, VisualSim.VS.dir, VisualSim.VS.dirAsURL, and user.dir.

 getProperty("java.home")

readFile

string

Return Type: string

Get the string text in the specified file, or throw an exception if the file cannot be found. The file can be absolute, or relative to the current working directory (user.dir), the user's home directory (user.home), or the classpath.

 readFile(File_Name)

readResource

string

Return Type: string

Get the string text in the specified resource (which is a file found relative to the classpath), or throw an exception if the file cannot be found.

readResource("VisualSim")

totalMemory

none

Return Type: long

Return the approximate number of bytes used by current objects plus those available for future object allocation.

 totalMemory( )