PlanetsCentral

Version 20241025

Site Help
...
PCC 2.0.12
Alphabetical Index
Dim (Elementary Command)

Dim [Local|Static|Shared] name [initializer],...

Create a variable.

You can create variables of different kind:

Local variables variables exist during the current subroutine or file only. This is the default.
Static variables exist during the current script execution.
Shared variables exist for all scripts you execute.

If you do specify a variable kind, you can omit the Dim keyword, i.e. Dim Static a is equivalent to Static a.

If the variable you create is indeed new, it will be initialized with the initializer (if no initializer is specified, it will start EMPTY). If the variable already exists, the initializer will be evaluated, but the variable keeps its original value.

The initializer can have the following forms:

`name(expr, ...)`	An array of the specified dimensions, all values EMPTY.
`name(expr, ...) As type`	An array of the specified dimensions, all values initialized with the specified type (see below).
`name := expression`	Initialized with the specified expression.
`name As type`	Initialized with the default value for the specified type.

The type can be a structure name defined with Struct to initialize the variable (or the array elements) with fresh instances of that structure, or one of the following:

Any	Allow any type, initialize with EMPTY.
Double	Fractional, initialize to 0.0.
Float	Fractional, initialize to 0.0.
Hash	Hash, initialize to a blank hash.
Integer	Integer, initialize to 0.
Long	Integer, initialize to 0.
Single	Fractional, initialize to 0.0.
String	String, initialize to "".

Examples:

  Dim a, b, c              % Three local variables
  Dim four = 4             % Local variable with value 4
  Dim i As Integer         % Local variable, integer
  Dim mat(10,10)           % 10x10 matrix (2-D array)
  Dim ps As MyStruct       % Structure
  Dim Shared gv            % Shared variable

Version Differences: PCC 1.x supports only simple value initialisations, and does not support arrays, hashes, or As initialisation.

Since: PCC 1.0.6, PCC2 1.99.8