Metacommand: Difference between revisions
Jump to navigation
Jump to search
No edit summary |
No edit summary |
||
| (15 intermediate revisions by the same user not shown) | |||
| Line 1: | Line 1: | ||
'''Metacommands''' are commands that start with '''dollar sign ($)'''. Those commands usually switch the program between different operation modes/behavior or provide extended functionality. | '''Metacommands''' are commands that start with '''dollar sign ($)'''. Those commands usually switch the program between different operation modes/behavior or provide extended functionality. | ||
| Line 11: | Line 10: | ||
* [[$INCLUDE]] {{Text|designates a text code library file to include with the program.}} | * [[$INCLUDE]] {{Text|designates a text code library file to include with the program.}} | ||
* [[$STATIC]] {{Text|set all program arrays as unchangeable in size using [[DIM]].}} | * [[$STATIC]] {{Text|set all program arrays as unchangeable in size using [[DIM]].}} | ||
=== Legacy style, but QB64-PE only === | |||
* [[$FORMAT]] {{Text|controls the code formatting behavior in QB64-PE its IDE and the command line formatting mode (-y switch).}} | |||
| Line 21: | Line 22: | ||
* [[$CONSOLE]] {{Text|creates a console window that can be used throughout a program.}} | * [[$CONSOLE]] {{Text|creates a console window that can be used throughout a program.}} | ||
* [[$DEBUG]] {{Text|enables debugging features, allowing you to step through your code line by line.}} | * [[$DEBUG]] {{Text|enables debugging features, allowing you to step through your code line by line.}} | ||
* [[$EXEICON]] {{Text|used with | * [[$EMBED]] {{Text|is used to embed any file's contents into the compiled executable. Recall the embedded file contents using [[_EMBEDDED$]].}} | ||
* [[$MIDISOUNDFONT]] {{Text|enables the MIDI support for [[_SNDOPEN]].}} | * [[$EXEICON]] {{Text|is used with an .ICO icon file name to embed the image into the compiled executable.}} | ||
* [[$NOPREFIX]] {{Text|allows QB64-specific keywords to be used without the underscore prefix.}} | * [[$INCLUDEONCE]] {{Text|prevents that include file contents is injected multiple times into a program.}} | ||
* [[$MIDISOUNDFONT]] ({{Text|deprecated|red}}) {{Text|enables the MIDI support for [[_SNDOPEN]].}} | |||
* [[$NOPREFIX]] ({{Text|deprecated|red}}) {{Text|allows QB64-specific keywords to be used without the underscore prefix.}} | |||
* [[$RESIZE]] {{Text|used with ON allows a user to resize the program window where OFF does not.}} | * [[$RESIZE]] {{Text|used with ON allows a user to resize the program window where OFF does not.}} | ||
* [[$SCREENHIDE]] {{Text|hides the program window from view.}} | * [[$SCREENHIDE]] {{Text|hides the program window from view.}} | ||
| Line 29: | Line 32: | ||
* [[$UNSTABLE]] {{Text|will enable the use of features that have not yet been made a permanent part of the language.}} | * [[$UNSTABLE]] {{Text|will enable the use of features that have not yet been made a permanent part of the language.}} | ||
* [[$VERSIONINFO]] {{Text|adds metadata to Windows only binaries for identification purposes across the OS.}} | * [[$VERSIONINFO]] {{Text|adds metadata to Windows only binaries for identification purposes across the OS.}} | ||
== | == QB64 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]] {{Text|used in conjunction with [[$IF]] for the precompiler.}} | * [[$ELSE]] {{Text|used in conjunction with [[$IF]] for the precompiler.}} | ||
| Line 48: | Line 50: | ||
{{ | {{PageReferences}} | ||
Latest revision as of 20:10, 12 May 2025
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 set all program arrays as changeable in size using REDIM.
- $INCLUDE designates a text code library file to include with the program.
- $STATIC set all program arrays as unchangeable in size using DIM.
Legacy style, but QB64-PE only
- $FORMAT controls the code formatting behavior in QB64-PE its IDE and the command line formatting mode (-y switch).
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.
- $EMBED is used to embed any file's contents into the compiled executable. Recall the embedded file contents using _EMBEDDED$.
- $EXEICON is used with an .ICO icon file name to embed the image into the compiled executable.
- $INCLUDEONCE prevents that include file contents is injected multiple times into a program.
- $MIDISOUNDFONT (deprecated) enables the MIDI support for _SNDOPEN.
- $NOPREFIX (deprecated) 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.
- $UNSTABLE will enable the use of features that have not yet been made a permanent part of the language.
- $VERSIONINFO adds metadata to Windows only binaries for identification purposes across the OS.
QB64 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