Metacommand: 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 |
||
| Line 7: | Line 7: | ||
==Legacy Metacommands (QBasic/QuickBASIC)== | ==Legacy Metacommands (QBasic/QuickBASIC)== | ||
:*Legacy metacommands are normally used at the program start, they should have their own program line and must be commented with an ''[[Apostrophe|']]'' or [[REM]]. | :*Legacy metacommands are normally used at the program start, they should have their own program line and must be commented with an ''[[Apostrophe|']]'' or [[REM]]. | ||
* [[$DYNAMIC]] | * [[$DYNAMIC]] {{Text|used at the start of a program to set all program arrays as changeable in size using [[REDIM]].}} | ||
* [[$INCLUDE]] | * [[$INCLUDE]] {{Text|designates a text code library file to include with the program.}} | ||
* [[$STATIC]] | * [[$STATIC]] {{Text|used at the start of a program to set all program arrays as unchangeable in size using [[DIM]].}} | ||
| Line 15: | Line 15: | ||
:*QB64 metacommands must not necessarily used at the program start. However, it's still the best location for some of it (see individual descriptions). | :*QB64 metacommands must not necessarily used at the program start. However, it's still the best location for some of it (see individual descriptions). | ||
:*QB64 metacommands must not be commented with an ''[[Apostrophe|']]'' or [[REM]], but should have their own program line too. | :*QB64 metacommands must not be commented with an ''[[Apostrophe|']]'' or [[REM]], but should have their own program line too. | ||
* [[$ASSERTS]] | * [[$ASSERTS]] {{Text|enables debug tests with the [[_ASSERT]] macro.}} | ||
* [[$CHECKING]] | * [[$CHECKING]] {{Text|turns event and error checking OFF or ON.}} | ||
* [[$COLOR]] | * [[$COLOR]] {{Text|includes named color name constants in a program.}} | ||
* [[$CONSOLE]] | * [[$CONSOLE]] {{Text|creates a console window that can be used throughout a program.}} | ||
* [[$DEBUG]] | * [[$DEBUG]] {{Text|enables debugging features, allowing you to step through your code line by line.}} | ||
* [[$EXEICON]] | * [[$EXEICON]] {{Text|used with a .ICO icon file name to embed the image into the QB64 executable.}} | ||
* [[$NOPREFIX]] | * [[$NOPREFIX]] {{Text|allows QB64-specific keywords to be used without the underscore prefix.}} | ||
* [[$RESIZE]] | * [[$RESIZE]] {{Text|used with ON allows a user to resize the program window where OFF does not.}} | ||
* [[$SCREENHIDE]] | * [[$SCREENHIDE]] {{Text|hides the program window from view.}} | ||
* [[$SCREENSHOW]] | * [[$SCREENSHOW]] {{Text|displays the program window after it was hidden.}} | ||
* [[$VERSIONINFO]] | * [[$VERSIONINFO]] {{Text|adds metadata to Windows only binaries for identification purposes across the OS.}} | ||
* [[$VIRTUALKEYBOARD]] | * [[$VIRTUALKEYBOARD]] ({{Text|deprecated|red}}) {{text|turns the virtual keyboard ON or OFF for use in touch-enabled devices.}} | ||
==OB64 Precompiler Commands== | ==OB64 Precompiler Commands== | ||
:*These are a special type of ''{{Text|QB64 Metacommands|blue}}'', which allow for conditional compiling, hence including or excluding certain code sections depending on given conditions. | :*These are a special type of ''{{Text|QB64 Metacommands|blue}}'', which allow for conditional compiling, hence including or excluding certain code sections depending on given conditions. | ||
* [[$ELSE]] | * [[$ELSE]] {{Text|used in conjunction with [[$IF]] for the precompiler.}} | ||
* [[$ELSEIF]] | * [[$ELSEIF]] {{Text|used in conjunction with [[$IF]] for the precompiler.}} | ||
* [[$END IF]] | * [[$END IF]] {{Text|used in conjunction with [[$IF]] for the precompiler.}} | ||
* [[$ERROR]] | * [[$ERROR]]) {{Text|used to trigger compiler errors from within the precompiling pass.}} | ||
* [[$IF]] | * [[$IF]] {{Text|used to set an [[IF]] condition for the precompiler.}} | ||
* [[$LET]] | * [[$LET]] {{Text|used to set a variable for the precompiler.}} | ||
{{PageSeeAlso}} | {{PageSeeAlso}} | ||
* [[Statement]] | * [[Statement]], [[Sub (explanatory)]] | ||
* [[Function (explanatory)]] | * [[Function (explanatory)]] | ||
* [[REM]] | * [[Apostrophe]], [[REM]] | ||
{{PageNavigation}} | {{PageNavigation}} | ||
Revision as of 23:05, 11 July 2022
Metacommands are commands that start with dollar sign ($). Those commands usually switch the program between different operation modes/behavior or provide extended functionality.
Legacy Metacommands (QBasic/QuickBASIC)
- $DYNAMIC used at the start of a program to set all program arrays as changeable in size using REDIM.
- $INCLUDE designates a text code library file to include with the program.
- $STATIC used at the start of a program to set all program arrays as unchangeable in size using DIM.
QB64 Metacommands
- $ASSERTS enables debug tests with the _ASSERT macro.
- $CHECKING turns event and error checking OFF or ON.
- $COLOR includes named color name constants in a program.
- $CONSOLE creates a console window that can be used throughout a program.
- $DEBUG enables debugging features, allowing you to step through your code line by line.
- $EXEICON used with a .ICO icon file name to embed the image into the QB64 executable.
- $NOPREFIX allows QB64-specific keywords to be used without the underscore prefix.
- $RESIZE used with ON allows a user to resize the program window where OFF does not.
- $SCREENHIDE hides the program window from view.
- $SCREENSHOW displays the program window after it was hidden.
- $VERSIONINFO adds metadata to Windows only binaries for identification purposes across the OS.
- $VIRTUALKEYBOARD (deprecated) turns the virtual keyboard ON or OFF for use in touch-enabled devices.
OB64 Precompiler Commands
- These are a special type of QB64 Metacommands, which allow for conditional compiling, hence including or excluding certain code sections depending on given conditions.
- $ELSE used in conjunction with $IF for the precompiler.
- $ELSEIF used in conjunction with $IF for the precompiler.
- $END IF used in conjunction with $IF for the precompiler.
- $ERROR) used to trigger compiler errors from within the precompiling pass.
- $IF used to set an IF condition for the precompiler.
- $LET used to set a variable for the precompiler.
See also