Difference between revisions of "COMMON"

From QB64 Wiki
Jump to navigation Jump to search
imported>Clippy
(Created page with 'The '''COMMON''' SHARED statement. ''See:'' COMMON SHARED')
 
imported>SMcNeill
m (-)
 
(18 intermediate revisions by 3 users not shown)
Line 1: Line 1:
The '''COMMON''' SHARED statement.
+
[[COMMON]] shares common variable values with other linked or [[CHAIN]]ed modules.
  
 +
==Legacy support==
 +
* The multi-modular technique goes back to when QBasic and QuickBASIC had module size constraints. In QB64 [[COMMON]] has been implemented so that that older code can still be compiled, though '''it is advisable to use single modules for a single project (not counting [[$INCLUDE]] libraries), for ease of sharing and also because the module size constraints no longer exist.'''
  
  
 +
{{PageSyntax}}
 +
: [[COMMON]] [SHARED] variableList
  
''See:'' [[COMMON SHARED]]
+
 
 +
{{PageDescription}}
 +
* COMMON must be called before any executable statements.
 +
* [[SHARED]] makes the variables shared within [[SUB]] and [[FUNCTION]] procedures within that module.
 +
* variableList is the list of common variables made available separated by commas.
 +
* Remember to keep the variable type ''order'' the same in all modules, as the variables names don't matter.
 +
* [[COMMON SHARED]] is most commonly used to share the variables with subs and functions of that module.
 +
* '''Note: Values assigned to shared variables used as procedure call parameters will not be passed to other procedures. The shared variable value must be assigned inside of the [[SUB]] or [[FUNCTION]] procedure to be passed.'''
 +
 
 +
 
 +
{{PageSeeAlso}}
 +
* [[COMMON SHARED]], [[CHAIN]]
 +
* [[DIM]], [[REDIM]], [[SHARED]]
 +
* [[DEFSTR]], [[DEFLNG]], [[DEFINT]], [[DEFSNG]], [[DEFDBL]]
 +
 
 +
{{PageNavigation}}

Latest revision as of 14:31, 10 September 2017

COMMON shares common variable values with other linked or CHAINed modules.

Legacy support

  • The multi-modular technique goes back to when QBasic and QuickBASIC had module size constraints. In QB64 COMMON has been implemented so that that older code can still be compiled, though it is advisable to use single modules for a single project (not counting $INCLUDE libraries), for ease of sharing and also because the module size constraints no longer exist.


Syntax

COMMON [SHARED] variableList


Description

  • COMMON must be called before any executable statements.
  • SHARED makes the variables shared within SUB and FUNCTION procedures within that module.
  • variableList is the list of common variables made available separated by commas.
  • Remember to keep the variable type order the same in all modules, as the variables names don't matter.
  • COMMON SHARED is most commonly used to share the variables with subs and functions of that module.
  • Note: Values assigned to shared variables used as procedure call parameters will not be passed to other procedures. The shared variable value must be assigned inside of the SUB or FUNCTION procedure to be passed.


See also



Navigation:
Go to Keyword Reference - Alphabetical
Go to Keyword Reference - By usage
Go to Main WIKI Page