Interface SignedInt4
access this type via: data.SignedInt4 (provides, requires or uses)
An object to represent and manipulate signed 32-bit integers (Dana primitive integers are all unsigned). These values are internally stored using two's complement. In general, Dana programs will use only int and dec types for their internal logic and will avoid the use of signed integers; this API is primarily intended to support the import and export of signed integers to external systems or data formats.
Functions
SignedInt4(optional int4 val, int4 neg)
int4 subtract(int4 val)
int4 add(int4 val)
int4 multiply(int4 val)
int4 divide(int4 val)
int4 getValue()
void setValue(int4 v)
bool isNegative()
void invert()
byte[] getBytes()
SignedInt4(optional int4 val, int4 neg)
Creates a new 32-bit signed integer instance, initialised either from an absolute value (val) or from a positive value which should be made negative (neg). An absolute value is assumed not to need any treatment and is set directly as the internal value of the signed integer (via new SignedInt4(n)). This value may either be intended as a positive integer, or a value from the getValue() function of another signed integer instance. A negative value (e.g. using new SignedInt4(neg = n)) is assumed to be a positive unsigned integer at the point of input, such as the value 4, which is converted to a negative value in the SignedInt4 instance, such as -4.
int4 subtract(int4 val)
Subtract a given 32-bit signed integer value from this instance's current value. The instance's current value is modified to equal the result, which is also returned.
int4 add(int4 val)
Add a given 32-bit signed integer value to this instance's current value. The instance's current value is modified to equal the result, which is also returned.
int4 multiply(int4 val)
Multiply this instance's current value by a given 32-bit signed integer value. The instance's current value is modified to equal the result, which is also returned.
int4 divide(int4 val)
Divide this instance's current value by a given 32-bit signed integer value. The instance's current value is modified to equal the result, which is also returned.
int4 getValue()
Get the value of this 32-bit signed integer, as an int4, suitable for use as a parameter to other SignedInt4 instances.
void setValue(int4 v)
Set the value of this 32-bit signed integer.
bool isNegative()
Test is this signed integer instance currently holds a negative value.
void invert()
Invert the sign of this signed integer instance, changing it from positive to negative, or vice-versa.
byte[] getBytes()
Get the raw bytes of this signed integer instance.