1
1
Fork 0
mirror of https://github.com/QB64-Phoenix-Edition/QB64pe.git synced 2024-07-01 13:50:36 +00:00
QB64-PE/internal/help/$CHECKING.txt
2017-10-10 11:55:21 -03:00

26 lines
1.2 KiB
Plaintext

The [[$CHECKING]] metacommand turns C++ event checking ON or OFF.
{{PageSyntax}}
: [[$CHECKING]]:{ON|OFF}
{{PageDescription}}
* The Metacommand does '''not''' require a comment or REM before it. There is no space after the colon.
* The OFF action turns event checking off and should '''only be used when running stable, errorless code.'''
* The default [[$CHECKING]]:ON action is only required when checking has been turned OFF previously.
* When [[$CHECKING]]:OFF is used, all error code and the reporting code is removed from the EXE program.
* '''Warning: Turning OFF error checking could create a General Protection Fault.
===Details===
* After every QB64 command is translated to C++, the compiler adds special code sections to check for [[ON TIMER (n)]] events and errors that may have occured in the last function call. Disabling error checking with the [[$CHECKING]]:OFF directive prevents the compiler from adding the extra code sections.
* Setting [[$CHECKING]]:OFF is only designed for 100% stable, error-less sections of code, where every CPU cycle saved counts, such as in a software 3D texture mapper, for example.
{{PageSeeAlso}}
* [[ON TIMER(n)]]
* [[ON ERROR]]
* [[Metacommand]]
* [[ERROR Codes]]
{{PageNavigation}}