Skip to content

UInteger

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

Purpose

Declares one or more UInteger (four byte unsigned integer) variables.

Syntax

To declare UInteger variables:

UInteger {identifier} [… {identifier}]

Where:

  • {identifier} is the name of a new UInteger 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 UInteger:

UInteger {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 UInteger command declares UInteger variables. The UInteger type is a 4-byte unsigned integer. The valid range of this data type is 0 to 4,294,967,295.

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

Examples

Procedure DoTest
    UInteger uMyVar
    Move 1 To uMyVar
End_Procedure

This example declares a UInteger variable named uMyVar and initializes it.

UInteger[] uLightYears

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

UInteger[5] uLightYears

This example declares a static array variable named uLightYears, containing 5 elements of type UInteger.

UInteger[][3] uLightYears

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