Types - nitrologic/monkey2 GitHub Wiki

@manpage Built-in types

Built-in data types

Primitive types

The following primtive types are supported:

Type Name	Description
Void	No type.
Bool	Boolean type.
Byte	8 bit signed integer.
UByte	8 bit unsigned integer.
Short	16 bit signed integer.
UShort	16 bit unsigned integer.
Int	32 bit signed integer.
UInt	32 bit unsigned integer.
Long	64 bit signed integer.
ULong	64 bit unsigned integer.
Float	32 bit floating point.
Double	64 bit floating point.
String	String of 16 bit characters.
Object	Base type of all objects.

Compound types

The following compound types are supported:

Type Syntax	Description
ElementType[]	Array type.
PointeeType Ptr	Pointer type.
ReturnType(ParameterTypes)	Function type.

Array types can have more than one dimension, for example: [,] declares a 2D array, [,,] declares a 3D array and so on.

The parameter types for a function type can optionally include an identifier prefix, for example: MyFunction:Int( arg:Int ). The prefix must be a valid identifier but is otherwise ignored.

Implicit type conversions

These type conversions are performed automatically:

Source type	Destination type
Bool	String
Any numeric type	Bool, String or any numeric type.
String or any array type	Bool
Any pointer type	Void Ptr
Class, interface or struct type	Bool
Class or interface type	Base class or implemented interface type
Enum type	Bool or any integral type.

When numeric values are converted to bool, the result will be true if the value is not equal to 0.

When strings and arrays are converted to bool, the result will be true if the length of the string or array is not 0.

When class or interface instances are converted to bool, the result will be true if the instance is not equal to null.

When struct values are converted to bool, the result will be true if the struct value is not equal to null.

When floating point values are converted to integral values, the fractional part of the floating point value is chopped off - no rounding is performed.

When bools are converted to strings, the result will be either "True" or "False".

Explicit type conversions

Some type conversions must be explicitly performed using the 'cast' operator. The cast operator has the syntax:

Cast<DestinationType>:DestinationType(SourceExpression)

You must use the cast operator to perform the following type conversions:

Source type	Destination type
Bool	Any numeric type
String	Any numeric type
Any pointer type	Any pointer type or any integral type
Any integral type	Any pointer type or any enum type.
Class type	Derived class or any interface type.
Interface type	Any class or interface type.

When using the cast operator to dynamically downcast an object or interface instance, the result will be Null if the cast failed.

When casting bool values to a numeric type, the result will be 1 for true, 0 for false.

You can also use 'function syntax' to explictly cast values to primitive types:

Local floatValue:Float=3.14
Local intValue:=Int( floatValue )