"Integer128" (Compiled Type)

"Integer128"

represents a 128-bit machine integer atomic type specifier.

Details

  • "Integer128" can be used in Typed and related constructs to specify a type.
  • An integer of type "Integer128" has a wider range than the machine integer expressions and has faster computation than software integer expressions.

Properties

  • Values held by "Integer128" range from -2127 to 2127-1.

Conversions

    From Expressions

  • Suitably sized Integer expressions can be converted into compiled code elements with the type "Integer128".

    • To Expressions

  • "Integer128" compiled elements can be converted into Integer expressions.

    • Arithmetic

  • "Integer128" compiled elements are automatically promoted to real or complex elements when they are combined in binary arithmetic operations.
  • Compiled elements with types smaller than "Integer128" are automatically promoted to "Integer128" when they are combined in binary arithmetic operations.
  • "Integer128" compiled elements are automatically promoted to "UnsignedInteger128" elements when they are combined in binary arithmetic operations.

Runtime Errors

    Overflow

  • "Integer128" can give a runtime error if it is used in an operation that overflows.

Examples

Basic Examples  (4)

"Integer128" can be used as an input and output from a CompiledCodeFunction:

An overflow causes an error while running the function. The computation is terminated, a message is issued and the Wolfram Engine is used to compute the result:

The "Integer128" argument is automatically promoted when combined with a real number:

When an "Integer128" argument is combined with an integer of a smaller storage size, the smaller type is automatically promoted:

The "Integer128" argument is automatically promoted when combined with an unsigned integer of the same storage size:

Computations with "Integer128" can work with integers that exceed the size of machine integer expressions:

The result was not a machine integer expression: