$INCLUDE: Difference between revisions
Jump to navigation
Jump to search
Navigation:
Main Page with Articles and Tutorials
Keyword Reference - Alphabetical
Keyword Reference - By usage
Report a broken link
No edit summary |
No edit summary |
||
| (14 intermediate revisions by the same user not shown) | |||
| Line 3: | Line 3: | ||
{{PageSyntax}} | {{PageSyntax}} | ||
: {[[REM]] | [[apostrophe|']] } [[$INCLUDE]]: | : {[[REM]] | [[apostrophe|']] } [[$INCLUDE]]''':''' '{{Parameter|sourceFile}}' | ||
| Line 12: | Line 12: | ||
* The $INCLUDE metacommand should be the only statement on a line. | * The $INCLUDE metacommand should be the only statement on a line. | ||
=== How to $INCLUDE a BAS or Text file with a QB64 Program === | |||
===How to $INCLUDE a BAS or Text file with a QB64 Program=== | |||
* Assemble the code to be reused into a file. | * Assemble the code to be reused into a file. | ||
* Common extensions are '''.BI''' (for declarations, usually included in the beginning of a program) or '''.BM''' (with SUBs and FUNCTIONs, usually included at the end of a program). | * Common extensions are '''.BI''' (for declarations, usually included in the beginning of a program) or '''.BM''' (with SUBs and FUNCTIONs, usually included at the end of a program). | ||
** Any extension can be used, as long as the file contains code in plain text (binary files are not accepted). | ** Any extension can be used, as long as the file contains code in plain text (binary files are not accepted). | ||
* $INCLUDE any [[DIM]], [[CONST]], [[SHARED]] arrays or [[DATA]] at the '''beginning''' of the main program code. | * $INCLUDE any [[DIM]], [[CONST]], [[SHARED]] arrays or [[DATA]] at the '''beginning''' of the main program code. | ||
* $INCLUDE [[SUB]]s or [[FUNCTION]]s at the bottom of the main program code '''after any SUB procedures.''' | * $INCLUDE [[SUB]]s or [[FUNCTION]]s at the bottom of the main program code '''after any SUB procedures.''' | ||
** '''Note:''' [[TYPE]] definitions, [[DATA]] and [[DECLARE LIBRARY]] can be placed inside of sub-procedures. | ** '''Note:''' [[TYPE]] definitions, [[DATA]] and [[DECLARE LIBRARY]] can be placed inside of sub-procedures. | ||
| Line 27: | Line 26: | ||
{{CodeStart}}''' '$INCLUDE:''' 'QB.BI'{{CodeEnd}} | {{CodeStart}}''' '$INCLUDE:''' 'QB.BI'{{CodeEnd}} | ||
=== More examples === | |||
===More examples=== | * [[SelectScreen]] | ||
* [[SelectScreen]] | * [[FILELIST$]] | ||
* [[FILELIST$]] | * [[SaveImage SUB]] | ||
* [[ | |||
{{PageSeeAlso}} | {{PageSeeAlso}} | ||
* [[INTERRUPT]], [[INTERRUPTX]] | * [[INTERRUPT]], [[INTERRUPTX]] | ||
* [[TYPE]], [[DIM]] | * [[TYPE]], [[DIM]] | ||
* [[Metacommand]] | * [[Metacommand]] | ||
Latest revision as of 20:00, 5 January 2024
$INCLUDE is a metacommand that is used to insert a source code file into your program which is then executed at the point of the insertion.
Syntax
Description
- QBasic metacommands must be commented with REM or an apostrophe.
- The sourceFile name must be enclosed in apostrophes and can include a path.
- $INCLUDE is often used to add functions and subs from an external text QBasic code library.
- The $INCLUDE metacommand should be the only statement on a line.
How to $INCLUDE a BAS or Text file with a QB64 Program
- Assemble the code to be reused into a file.
- Common extensions are .BI (for declarations, usually included in the beginning of a program) or .BM (with SUBs and FUNCTIONs, usually included at the end of a program).
- Any extension can be used, as long as the file contains code in plain text (binary files are not accepted).
- $INCLUDE any DIM, CONST, SHARED arrays or DATA at the beginning of the main program code.
- $INCLUDE SUBs or FUNCTIONs at the bottom of the main program code after any SUB procedures.
- Note: TYPE definitions, DATA and DECLARE LIBRARY can be placed inside of sub-procedures.
- Compile the program.
- Note: Once the program is compiled, the included text files are no longer needed with the program EXE.
Examples
'$INCLUDE: 'QB.BI' |
More examples
See also