CHAIN - QB64 Wiki


From QB64 Wiki

Jump to: navigation, search

CHAIN is used to change seamlessly from one module to another one in a program. Available in Quickbasic 4.0 and up.


CHAIN ModuleName$


  • The module name is a variable or a literal STRING value in quotation marks with the optional EXE or BAS file name extension.


  • CHAIN requires that both the invoking and called modules are of either .BAS or .EXE file types!
  • In Windows, QB64 will automatically compile a CHAIN referenced BAS file if there is no EXE file found.
  • CHAIN looks for a file extension that is the same as the invoking module's extension.
  • The module's filename extension is NOT required. To save editing at compile time just omit the extensions in the calls.
  • To pass data from one module to the other use COMMON SHARED. The COMMON list should match types and names!
  • Compiled EXE files MUST include BRUN45.EXE in QuickBasic 4.5 when CHAIN is used with COMMON SHARED.
  • Module screen modes will not change unless that is desired. QB64 currently does not retain the SCREEN mode!
  • Use when modules are too large to compile(Over 100K approx.). Split the modules up. NOT necessary with QB64!
  • Variable data can be passed in files instead of using COMMON SHARED values. QB64 uses files to pass COMMON lists.
  • NOTE: CHAIN is no longer required using QB64 as it can run larger modules: Not currently available in Linux or Mac operating systems!

Example: CHAIN looks for same file type extension as program module (BAS or EXE) in QB 4.5.

CHAIN "Level1"

Explanation: The file referred to is "Level1.BAS" if the program module using the call is a BAS file. If the program was compiled, it would look for "Level1.EXE". QuickBasic4.5 requires that COMMON or COMMON SHARED data sharing programs be compiled with BRUN45.EXE being included with the program package(the EXE file will also be larger). QB64 does not have that requirement as it creates data files to pass common data information.

See also:

Go to Keyword Reference - Alphabetical
Go to Keyword Reference - By usage
Go to Main WIKI Page
Personal tools