Skip to content

BigInt

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

Purpose

Declares one or more BigInt (eight-byte integer) variables.

Syntax

To declare BigInt variables:

BigInt {identifier} [… {identifier}]

Where:

  • {identifier} is the name of a new BigInt variable. The first {identifier} is required.
  • {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 BigInt:

BigInt {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, i.e., [{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 BigInt command declares eight-byte integer variables, the range of which is -9223372036854775808 to 9223372036854775807 (-9,223,372,036,854,775,808 to 9,223,372,036,854,775,807).

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

Examples

Procedure Test
    BigInt biMyVar
    Move 1000000000000000 To biMyVar
End_Procedure

This example declares a BigInt variable named biMyVar and initializes its value.

BigInt[] biDriveSizeInBytes

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

BigInt[5] biDriveSizeInBytes

This example declares a static array variable named biDriveSizeInBytes, containing 5 elements of type BigInt.

BigInt[][3] biDriveSizeInBytes

This example creates a two-dimensional dynamic array variable named biDriveSizeInBytes, containing an undefined number of elements of type BigInt. 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 BigInt variables, but any decimal values that result will be truncated without report of error.
  • If you need to define a global BigInt variable, you should use the global_variable command to do so.