Variable declaration and scope modifier
Syntax
Description
Declares a variable which is shared between code modules, including those to be compiled as static and dynamic libraries (DLLs).
A matching
Common statement must appear in all other code modules using the variable.
Common variables cannot be initialized.
Common arrays are always variable-length, and must be defined with an empty parameter list
(), and its dimensions set in a later
Dim or
ReDim statement.
Common variables cannot be instances of a user-defined type having a constructor or a destructor even implicit.
The
Shared optional parameter makes the variable global so that it can be used inside
Subs and
Functions, as well as at module level.
Example
'' common1.bas
Declare Sub initme()
Common Shared foo() As Double
ReDim foo(0 To 2)
initme()
Print foo(0), foo(1), foo(2)
'' common2.bas
Common Shared foo() As Double
Sub initme()
foo(0) = 4*Atn(1)
foo(1) = foo(0)/3
foo(2) = foo(1)*2
End Sub
After compiling the two files like:
fbc common1.bas common2.bas
running
common1 produces the output:
3.141592653589793 1.047197551196598 2.094395102393195
Platform Differences
- Windows does not support Common with a dynamic library (compiled with -dll or -dylib).
Differences from QB
- The arrays will be always variable-length.
- blockname is not needed and must be removed because the order of declaration no longer matters, only the symbol names.
- Common does not allow to keep the values of certain variables when chaining programs with Chain.
See also