"UnsignedMachineInteger" (Compiled Type)

"UnsignedMachineInteger"

represents a machine-sized unsigned integer atomic type specifier.

Details

  • "UnsignedMachineInteger" can be used in Typed and related constructs to specify a type.
  • On 64-bit platforms, "UnsignedMachineInteger" is an "UnsignedInteger64".
  • On 32-bit platforms, "UnsignedMachineInteger" is an "UnsignedInteger32".

Properties

  • Values held by "UnsignedMachineInteger" range from 0 to 264-1 on 64-bit architectures.
  • Values held by "UnsignedMachineInteger" range from 0 to 232-1 on 32-bit architectures.

Conversions

    From Expressions

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

  • "UnsignedMachineInteger" compiled elements can be converted into Integer expressions.
  • Arithmetic

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

Run-Time Errors

    Overflow

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

Examples

Basic Examples  (4)

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

In[1]:=
Click for copyable input
Out[1]=
In[2]:=
Click for copyable input
Out[2]=

"UnsignedMachineInteger" has the same size as $SystemWordLength:

In[3]:=
Click for copyable input
Out[3]=

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:

In[1]:=
Click for copyable input
Out[1]=

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

In[1]:=
Click for copyable input
Out[1]=

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

In[2]:=
Click for copyable input
Out[2]=

"UnsignedMachineInteger" is useful for working with "PackedArray", since this takes integers of the native size for the architecture:

In[1]:=
Click for copyable input
Out[1]=
In[2]:=
Click for copyable input
Out[2]=