Skip to content

UBigInt

See Also: Declaring Variables, Variable Declaration Commands, Struct, Integer, BigInt

Purpose

Declares one or more UBigInt (eight byte unsigned integer) variables.

Syntax

To declare UBigInt variables:

UBigInt {identifier} [… {identifier}]

Where:

  • {identifier} is the name of a new UBigInt variable.
  • {identifier} may be between 1 and 4096 characters in length, must start with a letter, and may not contain spaces. Recommended characters are 0-9, a-z, A-Z, and _ (underscore).

To declare array variables of type UBigInt:

UBigInt {dimension-list} {identifier} [… {identifier}]

Where:

  • {dimension-list} is a list of one or more array dimensions for the array. A dimension list is declared using square brackets []. One pair of brackets is used to declare each dimension. If the array is static, then you must specify the static size of each dimension between each pair of brackets, e.g., [{size}]. For more information about declaring arrays, refer to Array Variable Assignments.
  • {identifier} may be between 1 and 4096 characters in length, must start with a letter, and may not contain spaces. Recommended characters are 0-9, a-z, A-Z, and _ (underscore).

What It Does

The UBigInt command declares unsigned integer variables of eight bytes in the range of 0 to 18,446,744,073,709,551,615 (0 to 18446744073709551615).

Multiple variables may be declared on one command line, with their names separated from each other by spaces.

Examples

Procedure DoTest
    UBigInt ubiMyVar
    Move 1000000000000000 To ubiMyVar
End_Procedure

This example declares a UBigInt variable named ubiMyVar and initializes it.

UBigInt[] siLightYears

This example declares a dynamic array variable named siLightYears, containing an undefined number of elements of type UBigInt.

UBigInt[5] siLightYears

This example declares a static array variable named siLightYears, containing 5 elements of type UBigInt.

UBigInt[][3] siLightYears

This example creates a two-dimensional dynamic array variable named siLightYears, containing an undefined number of elements of type UBigInt. Conceptually, this represents a rectangular array with an undefined number of rows, each of 3 columns.

You can declare dynamic multi-dimensional arrays where all dimensions are dynamic; these are called jagged arrays.

Notes

  • You may do calculations with UBigInt variables, but any decimal values that result will be truncated without report of error.
  • Use the Move command to initialize the value of a UBigInt.
  • If you need to define a global UBigInt variable, you should use the global_variable command to do so.