17.4 Types

The following type specifications are allowed in the declarations of parameters and results. Each item in the list below describes the values permitted by the type.

int

An integer. Integers can be written in decimal, hex (0x1e3) or binary (0b1011).

float

A floating-point number or integer.

string

Any string, like "Miss Piggy". Quotes can be omitted for word-like strings, like x86_64.

bool

Either TRUE or FALSE.

file(PATTERN)

A string that names an existing file. PATTERN is a (double-quoted) string with a pattern that suggests what file names are acceptable, such as "*.exe". The pattern is just a hint for the user interface; any existing file will be accepted. Use file("*") to indicate no particular file name preference.

File names may start with %simics% to force a look-up relative the current project and Simics package path, or with %script% representing the script directory itself. (%script% is only allowed in default values.)

{VALUE1, VALUE2, ...}

One of the enumerated values (which each can be of any type).

Example: {1, "apple pie", 8.25}

TYPE or nil

A value that matches TYPE or is the value NIL.

Example: string or nil will match "abc" or NIL, but not 1.3.

Complex or compound data types can often be packed into a string and unpacked and verified by the receiver in Simics. See documentation of the split-string command.