QB64/QB64-PE
QB64/QB64-PE
1
1
Fork 0
mirror of https://github.com/QB64-Phoenix-Edition/QB64pe.git synced 2024-07-01 15:00:38 +00:00
Code Issues Releases Wiki Activity

Updates help files.

Browse source
This commit is contained in:
Fellippe Heitor 2021-04-25 19:40:25 -03:00
parent 50e877acf5
commit b6705f2880
89 changed files with 308 additions and 303 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

4
internal/help/$ASSERTS.txt
View file

@ -10,8 +10,8 @@ The [[$ASSERTS]] metacommand enables debug tests with the [[_ASSERT]] macro.
* If an error message is passed to the [[_ASSERT]] statement, it is displayed in the console window if [[$ASSERTS|$ASSERTS:CONSOLE]] is used.
==Availability==
* '''Version 1.4 and up'''.
{{PageAvailability}}
* Version 1.4 and up.
{{PageExamples}}

9
internal/help/$CONSOLE.txt
View file

@ -1,19 +1,20 @@
The [[$CONSOLE]] [[Metacommand]] creates a console window that can be used throughout a QB64 program module.
The [[$CONSOLE]] [[metacommand]] creates a console window that can be used throughout a QB64 program module.
{{PageSyntax}}
: [[$CONSOLE]][:ONLY]
{{Description}}
* [[_CONSOLE]] '''ON''' or '''OFF''' may be used to show or hide the console window at run time.
* The ''':ONLY''' option can be used when only a console window is desired without a program window.
* [[_DEST]] [[_CONSOLE]] may be used to send screen output to the console window.
* [[_SCREENHIDE]] and [[_SCREENSHOW]] can be used to hide or show the main program window.
* [[_DELAY]] or [[SLEEP]] can be used to allow the console window to be set in front of the main program window.
* '''QB64 [[Metacommand]]s are not commented out with ' or REM, differently from QBasic metacommands'''
* Change the title of the [[$CONSOLE]] windows created using [[_CONSOLETITLE]]
* [[_CONSOLETITLE]] can be used to change the title of the console window.
* '''Note:''' Text can be copied partially or totally from console screens in Windows by highlighting and using the title bar menu.
:: To copy console text output, right click the title bar and select ''Edit'' for ''Mark'' to highlight and repeat to ''Copy''
:: To copy console text output, right click the title bar and select ''Edit'' for ''Mark'' to highlight and repeat to ''Copy''
* QB64 [[Metacommand]]s are not commented out with ' or REM, differently from QBasic metacommands.
{{PageExamples}}

2
internal/help/$LET.txt
View file

@ -1,4 +1,4 @@
[[$LET]] is precompiler command, which is now usable by modern day [[cavemen]] to help include and exclude which sections of code compiles in their program based on OS/bit-size or other predefined conditions.
[[$LET]] is a precompiler command, which is now usable by modern day [[cavemen]] to help include and exclude which sections of code compiles in their program based on OS/bit-size or other predefined conditions.
{{PageSyntax}}

4
internal/help/$NOPREFIX.txt
View file

@ -14,8 +14,8 @@ The [[$NOPREFIX]] metacommand allows all QB64 functions and statements to be use
* [[$NOPREFIX]] must be the first non-comment and non-whitespace line in a program.
==Availability==
* '''Version 1.4 and up'''.
{{PageAvailability}}
* Version 1.4 and up.
{{PageSeeAlso}}

4
internal/help/$RESIZE.txt
View file

@ -12,8 +12,8 @@ The [[$RESIZE]] [[Metacommand|metacommand]] determines if a program window can b
* $RESIZE:SMOOTH the screen will be stretched also, but with linear filtering applied to the pixels.
==Availability==
* '''Version 1.000 and up'''.
{{PageAvailability}}
* Version 1.000 and up.
{{PageExamples}}

4
internal/help/$VERSIONINFO.txt
View file

@ -17,8 +17,8 @@ The [[$VERSIONINFO]] [[Metacommand|metacommand]] adds text metadata to the resul
* [[Keywords_currently_not_supported_by_QB64#Keywords_Not_Supported_in_Linux_or_MAC_OSX_versions|Not available in Linux or macOS]].
==Availability==
* '''Build 20170429/52 and up'''.
{{PageAvailability}}
* Build 20170429/52 and up.
{{PageExamples}}

7
internal/help/%2F.txt
View file

@ -1,14 +1,11 @@
The '''/''' mathematical operator performs decimal point division on a numerical value.
The [[/]] mathematical operator performs decimal point division on a numerical value.
{{PageSyntax}}
::: return_value = number '''/''' divisor
:return_value = number [[/]] divisor
{{PageDescription}}
* Number value can be any literal or variable numerical type.
* Return values can be any literal or variable numerical type, but [[SINGLE]] or [[DOUBLE]] type decimal point returns are likely.
* Values returned may be expressed using exponential or [[scientific notation]] using '''E''' for SINGLE or '''D''' for DOUBLE precision.

7
internal/help/-.txt
View file

@ -1,13 +1,11 @@
The '''-''' mathematical operator performs subtraction on two numerical values or [[negation|negates]] a single value.
The [[-]] mathematical operator performs subtraction on two numerical values or [[negation|negates]] a single value.
{{PageSyntax}}
return_value = number1 - number2
:return_value = number1 [[-]] number2
{{PageDescription}}
* Numbers used can be any literal or variable numerical value type.
* Subtracting a negative value will actually perform addition with the other value.
* Subtracting a negative or [[negation|negated]] value will make the return value more positive.
@ -16,7 +14,6 @@ return_value = number1 - number2
{{PageSeeAlso}}
* [[+|+ positive]] (addition operator)
* [[Mathematical Operations]]

7
internal/help/.txt
View file

@ -1,14 +1,11 @@
The '''\''' mathematical operator performs [[INTEGER]] division on a numerical value.
The [[\]] mathematical operator performs [[INTEGER]] division on a numerical value.
{{PageSyntax}}
::: return_value = number '''\''' divisor
:return_value = number [[\]] divisor
{{PageDescription}}
* Number value can be any literal or variable numerical type.
* '''Divisor (second value) must not be a value of 0 to .5'''. This will create a [[ERROR Codes|"Division by zero" error!]] due to [[CINT]] rounding.
* Return values will be [[INTEGER]] or [[LONG]] value types only.

58
internal/help/ATN.txt
View file

@ -30,7 +30,7 @@ y = 100 * {{Cl|SIN}}({{Cl|ATN}}(1))
{{CodeStart}} '' ''
Pi = 4 * {{Cl|ATN}}(1) '{{Cl|SINGLE}} precision
Pi# = 4 * {{Cl|ATN}}(1#) '{{Cl|DOUBLE}} precision
PRINT Pi, Pi# '' ''
{{Cl|PRINT}} Pi, Pi# '' ''
{{CodeEnd}}
:''Note:'' You can use QB64's native [[_PI]] function.
@ -41,38 +41,38 @@ PRINT Pi, Pi# '' ''
x1! = 320
y1! = 240
DO
{{Cl|PRESET}} (x1!, y1!), {{Cl|_RGB}}(255, 255, 255)
dummy% = {{Cl|_MOUSEINPUT}}
x2! = {{Cl|_MOUSEX}}
y2! = {{Cl|_MOUSEY}}
{{Cl|LINE}} (x1, y1)-(x2, y2), {{Cl|_RGB}}(255, 0, 0)
{{Cl|LOCATE}} 1, 1: {{Cl|PRINT}} getangle(x1!, y1!, x2!, y2!)
{{Cl|_DISPLAY}}
{{Cl|_LIMIT}} 200
{{Cl|CLS}}
{{Cl|DO}}
{{Cl|PRESET}} (x1!, y1!), {{Cl|_RGB}}(255, 255, 255)
dummy% = {{Cl|_MOUSEINPUT}}
x2! = {{Cl|_MOUSEX}}
y2! = {{Cl|_MOUSEY}}
{{Cl|LINE}} (x1, y1)-(x2, y2), {{Cl|_RGB}}(255, 0, 0)
{{Cl|LOCATE}} 1, 1: {{Cl|PRINT}} getangle(x1!, y1!, x2!, y2!)
{{Cl|_DISPLAY}}
{{Cl|_LIMIT}} 200
{{Cl|CLS}}
{{Cl|LOOP}} {{Cl|UNTIL}} {{Cl|INKEY$}} <> ""
{{Cl|END}}
{{Cl|FUNCTION}} getangle# (x1#, y1#, x2#, y2#) 'returns 0-359.99...
{{Cl|IF...THEN|IF}} y2# = y1# {{Cl|THEN}}
{{Cl|IF...THEN|IF}} x1# = x2# {{Cl|THEN}} {{Cl|EXIT FUNCTION}}
{{Cl|IF...THEN|IF}} x2# > x1# {{Cl|THEN}} getangle# = 90 {{Cl|ELSE}} getangle# = 270
{{Cl|EXIT FUNCTION}}
{{Cl|END IF}}
{{Cl|IF...THEN|IF}} x2# = x1# {{Cl|THEN}}
{{Cl|IF...THEN|IF}} y2# > y1# {{Cl|THEN}} getangle# = 180
{{Cl|EXIT FUNCTION}}
{{Cl|END IF}}
{{Cl|IF...THEN|IF}} y2# < y1# {{Cl|THEN}}
{{Cl|IF...THEN|IF}} x2# > x1# {{Cl|THEN}}
getangle# = {{Cl|ATN}}((x2# - x1#) / (y2# - y1#)) * -57.2957795131
{{Cl|ELSE}}
getangle# = {{Cl|ATN}}((x2# - x1#) / (y2# - y1#)) * -57.2957795131 + 360
{{Cl|END IF}}
{{Cl|ELSE}}
getangle# = {{Cl|ATN}}((x2# - x1#) / (y2# - y1#)) * -57.2957795131 + 180
{{Cl|END IF}}
{{Cl|IF...THEN|IF}} y2# = y1# {{Cl|THEN}}
{{Cl|IF...THEN|IF}} x1# = x2# {{Cl|THEN}} {{Cl|EXIT FUNCTION}}
{{Cl|IF...THEN|IF}} x2# > x1# {{Cl|THEN}} getangle# = 90 {{Cl|ELSE}} getangle# = 270
{{Cl|EXIT FUNCTION}}
{{Cl|END IF}}
{{Cl|IF...THEN|IF}} x2# = x1# {{Cl|THEN}}
{{Cl|IF...THEN|IF}} y2# > y1# {{Cl|THEN}} getangle# = 180
{{Cl|EXIT FUNCTION}}
{{Cl|END IF}}
{{Cl|IF...THEN|IF}} y2# < y1# {{Cl|THEN}}
{{Cl|IF...THEN|IF}} x2# > x1# {{Cl|THEN}}
getangle# = {{Cl|ATN}}((x2# - x1#) / (y2# - y1#)) * -57.2957795131
{{Cl|ELSE}}
getangle# = {{Cl|ATN}}((x2# - x1#) / (y2# - y1#)) * -57.2957795131 + 360
{{Cl|END IF}}
{{Cl|ELSE}}
getangle# = {{Cl|ATN}}((x2# - x1#) / (y2# - y1#)) * -57.2957795131 + 180
{{Cl|END IF}}
{{Cl|END FUNCTION}} '' ''
{{CodeEnd}}{{small|Function by Galleon}}

2
internal/help/COLOR.txt
View file

@ -10,6 +10,8 @@ The [[COLOR]] statement is used to change the foreground and background colors f
* To change the {{Parameter|background&}} color only, use a comma and the desired color. Ex: [[COLOR]] , {{Parameter|background&}}
* Graphic drawing statements like [[PSET]], [[PRESET]], [[LINE]], etc, also use the colors set by the [[COLOR]] statement if no color is passed when they are called.
* The [[$COLOR]] metacommand adds named color constants for both text and 32-bit modes.
* [[COLOR]] works when outputting text to [[$CONSOLE]].
** On macOS, colors in console mode will not match the VGA palette. See [https://en.wikipedia.org/wiki/ANSI_escape_code#8-bit 8-bit ANSI colors]
==Screen Mode Attributes==

2
internal/help/Cavemen.txt
View file

@ -7,7 +7,7 @@
* Why are you here? Did you look up '''LET'''? Too bad! Tell your teacher to actually teach you something!
''See also:''
{{PageSeeAlso}}
* [[LET]] there be light!
* [[LET|Allow me to go back]]

9
internal/help/DECLARE_DYNAMIC_LIBRARY.txt
View file

@ -18,7 +18,7 @@
* ''Procedure_name'' is any procedure name you want to designate by using [[ALIAS]] with the ''Library_procedure'' name following.
* ''Parameters'' used by the Library procedure must be passed by value ([[BYVAL]]) except for [[STRING]] values.
* '''''.h'' header files cannot be used with DECLARE DYNAMIC LIBRARY. Existence of any ''.h'' file of the same name as the ''.DLL'' file will cause DECLARE DYNAMIC LIBRARY to fail.'''
* '''IMPORTANT:''' [[DECLARE DYNAMIC LIBRARY]] let's you specify any SUB/FUNCTION calling format you wish, but '''if the size of the parameters does not match, the size expected within the library your code will probably cause a GPF (General Protection Fault).''' It is important to understand that you are creating a 32-bit program (even under 64-bit Windows) so '''pointers (if required) will be 32-bits in size, the equivalent of a [[LONG]].'''
* '''IMPORTANT:''' [[DECLARE DYNAMIC LIBRARY]] let's you specify any SUB/FUNCTION calling with the format you wish, but '''if the size of the parameter list does not match the size expected within the library, then your code will probably cause a GPF (General Protection Fault).
* '''STATIC''' is the same as [[DECLARE LIBRARY]] except that it prioritizes linking to static libraries (*.a/*.o) over shared object (*.so) libraries, if both exist. As Windows doesn't really use shared libraries (DLLs are a bit different) this does not affect Windows users.
* The [[_OFFSET]] in memory can be used in '''CUSTOMTYPE''', '''STATIC''' and '''DYNAMIC LIBRARY''' declarations.
* [[SUB]] procedures using DECLARE CUSTOMTYPE LIBRARY API procedures '''may error'''. Try DYNAMIC with the DLL name.
@ -26,10 +26,9 @@
* '''NOTE: It is up to the user to document and determine the suitability of all Libraries and procedures they choose to use. QB64 cannot guarantee that any procedure will work and cannot quarantee any troubleshooting help.'''
==Availability==
* '''Version 0.923 and up (Windows)'''
* '''Version 0.94 and up (Linux and macOS)'''
{{PageAvailability}}
* Version 0.923 and up (Windows).
* Version 0.94 and up (Linux and macOS).
{{PageExamples}}

4
internal/help/EXIT.txt
View file

@ -19,8 +19,8 @@ The [[EXIT]] statement is used to exit certain QBasic procedures.
* To exit the program immediately, use [[SYSTEM]].
== Availability ==
* '''EXIT SELECT/CASE''' available with v1.5.
{{PageAvailability}}
* '''EXIT SELECT/CASE''' available with version 1.5.
* All other variants available in all versions of QB64.

2
internal/help/INSTR.txt
View file

@ -19,6 +19,7 @@ The [[INSTR]] function searches for the first occurence of a search [[STRING]] w
* The {{Parameter|searchString$}} should be smaller or equal in [[LEN|length]] to the {{Parameter|baseString$}}, or 0 is returned.
* Non-zero {{Parameter|position%}} return values can be used as a new start position by adding 1 to re-search the base string. See the example below.
* In a loop, INSTR can search an entire file for occurences of certain words. See the [[MID$ (statement)|MID$]] statement example.
* To search right to left, use [[_INSTRREV]]
{{PageQBasic}}
@ -49,6 +50,7 @@ There is 'cats' in the string at position: 62
* [[LEFT$]], [[RIGHT$]]
* [[LCASE$]], [[UCASE$]]
* [[STRING]], [[INTEGER]]
* [[_INSTRREV]]
{{PageNavigation}}

32
internal/help/Keyword_Reference_-_Alphabetical.txt
View file

@ -30,19 +30,19 @@ __NOTOC__
<div id = "uA">_A</div>
* [[_ACCEPTFILEDROP]] (statement) {{text|turns a program window into a valid drop destination for dragging files from Windows Explorer.}}
* [[_ACOS]] (function) {{text|arccosine function returns the angle in radians based on an input [[COS]]ine value range from -1 to 1.}}
* [[_ACOSH]] (function) {{text|Returns the nonnegative arc hyperbolic cosine of x, expressed in radians.}}
* [[_ACOSH]] (function) {{text|returns the nonnegative arc hyperbolic cosine of x, expressed in radians.}}
* [[_ALLOWFULLSCREEN]] (statement) {{text|allows setting the behavior of the ALT+ENTER combo.}}
* [[_ALPHA]] (function) {{text|returns the alpha channel transparency level of a color value used on a screen page or image.}}
* [[_ALPHA32]] (function) {{text|returns the alpha channel transparency level of a color value used on a 32 bit screen page or image.}}
* [[Mathematical_Operations|_ARCCOT]] (function) {{text|is the inverse function of the cotangent. . http://mathworld.wolfram.com/InverseCosecant.html}}
* [[Mathematical_Operations|_ARCCSC]] (function) {{text|is the inverse function of the cosecant. http://mathworld.wolfram.com/InverseCosecant.html}}
* [[Mathematical_Operations|_ARCSEC]] (function) {{text|is the inverse function of the secant. http://mathworld.wolfram.com/InverseSecant.html}}
* [[_ASIN]] (function) {{text|Returns the principal value of the arc sine of x, expressed in radians.}}
* [[_ASINH]] (function) {{text|Returns the arc hyperbolic sine of x, expressed in radians.}}
* [[_ASSERT]] (statement) {{text|Performs debug tests.}}
* [[$ASSERTS]] ([[metacommand]]) {{text|Enables the [[_ASSERT]] macro}}
* [[_ATAN2]] (function) {{text|Returns the principal value of the [[ATN|arc tangent]] of y/x, expressed in radians.}}
* [[_ATANH]] (function) {{text|Returns the arc hyperbolic tangent of x, expressed in radians.}}
* [[_ASIN]] (function) {{text|returns the principal value of the arc sine of x, expressed in radians.}}
* [[_ASINH]] (function) {{text|returns the arc hyperbolic sine of x, expressed in radians.}}
* [[_ASSERT]] (statement) {{text|performs debug tests.}}
* [[$ASSERTS]] ([[metacommand]]) {{text|enables the [[_ASSERT]] macro}}
* [[_ATAN2]] (function) {{text|returns the principal value of the [[ATN|arc tangent]] of y/x, expressed in radians.}}
* [[_ATANH]] (function) {{text|returns the arc hyperbolic tangent of x, expressed in radians.}}
* [[_AUTODISPLAY]] (statement) {{text|enables the automatic display of the screen image changes previously disabled by [[_DISPLAY]].}}
* [[_AUTODISPLAY (function)]] {{text|returns the current display mode as true (-1) if automatic or false (0) if per request using [[_DISPLAY]].}}
* [[_AXIS]] (function) {{text|returns a [[SINGLE]] value between -1 and 1 indicating the maximum distance from the device axis center, 0.}}
@ -72,8 +72,8 @@ __NOTOC__
* [[_CAPSLOCK (function)]] {{text|returns -1 when Caps Lock is on}}
* [[_CAPSLOCK]] (statement) {{text|sets Caps Lock key state}}
* [[$CHECKING]] ([[metacommand]]) {{text|turns event error checking OFF or ON.}}
* [[_CEIL]] (function) {{text|Rounds x upward, returning the smallest integral value that is not less than x.}}
* [[_CINP]] (function) {{text|Returns a key code from $CONSOLE input}}
* [[_CEIL]] (function) {{text|rounds x upward, returning the smallest integral value that is not less than x.}}
* [[_CINP]] (function) {{text|returns a key code from $CONSOLE input}}
* [[_CLEARCOLOR (function)]] {{text|returns the current transparent color of an image.}}
* [[_CLEARCOLOR]] (statement) {{text|sets a specific color index of an image to be transparent}}
* [[_CLIP]] ([[PUT (graphics statement)|PUT]] graphics option) {{text|allows placement of an image partially off of the screen.}}
@ -95,10 +95,10 @@ __NOTOC__
* [[_COPYIMAGE]] (function) {{text|copies an image handle value to a new designated handle.}}
* [[_COPYPALETTE]] (statement) {{text|copies the color palette intensities from one 4 or 8 BPP image to another image.}}
* [[Mathematical_Operations|_COT]] (function) {{text| the mathematical function cotangent defined by 1/TAN. http://mathworld.wolfram.com/Cotangent.html}}
* [[Mathematical_Operations|_COTH]] (function) {{text|Returns the hyperbolic cotangent. http://mathworld.wolfram.com/HyperbolicCotangent.html}}
* [[Mathematical_Operations|_COSH]] (function) {{text|Returns the hyperbolic cosine of x radians. http://mathworld.wolfram.com/HyperbolicCosine.html}}
* [[Mathematical_Operations|_COTH]] (function) {{text|returns the hyperbolic cotangent. http://mathworld.wolfram.com/HyperbolicCotangent.html}}
* [[Mathematical_Operations|_COSH]] (function) {{text|returns the hyperbolic cosine of x radians. http://mathworld.wolfram.com/HyperbolicCosine.html}}
* [[Mathematical_Operations|_CSC]] (function) {{text| the mathematical function cosecant defined by 1/SIN. http://mathworld.wolfram.com/Cosecant.html}}
* [[Mathematical_Operations|_CSCH]] (function) {{text|Returns the hyperbolic cosecant. http://mathworld.wolfram.com/HyperbolicCosecant.html}}
* [[Mathematical_Operations|_CSCH]] (function) {{text|returns the hyperbolic cosecant. http://mathworld.wolfram.com/HyperbolicCosecant.html}}
* [[_CV]] (function) {{text|converts any [[_MK$]] [[STRING]] value to the designated numerical type value.}}
* [[_CWD$]] (function) {{text|returns the current working directory as a [[STRING]] value.}}
@ -184,7 +184,7 @@ __NOTOC__
<div id = "uH">_H</div>
* [[_HEIGHT]] (function) {{text|returns the height of a designated image handle.}}
* [[_HIDE]] ([[SHELL]] action) {{text| hides the command line display during a shell.}}
* [[_HYPOT]] (function) {{text|Returns the hypotenuse of a right-angled triangle whose legs are x and y.}}
* [[_HYPOT]] (function) {{text|returns the hypotenuse of a right-angled triangle whose legs are x and y.}}
----
@ -330,7 +330,7 @@ __NOTOC__
<div id = "uS">_S</div>
* [[Mathematical_Operations#Derived_Mathematical_Functions|_SEC]] (function) {{text| the mathematical function secant defined by 1/COS. http://mathworld.wolfram.com/Secant.html}}
* [[Mathematical_Operations#Derived_Mathematical_Functions|_SECH]] (function) {{text|Returns the hyperbolic secant. http://mathworld.wolfram.com/HyperbolicSecant.html}}
* [[Mathematical_Operations#Derived_Mathematical_Functions|_SECH]] (function) {{text|returns the hyperbolic secant. http://mathworld.wolfram.com/HyperbolicSecant.html}}
* [[_SCREENCLICK]] (statement) {{text|simulates clicking on a point on the desktop screen with the left mouse button.}}
* [[_SCREENEXISTS]] (function) {{text|returns a -1 value once a screen has been created.}}
* [[$SCREENHIDE]] ([[metacommand]]) {{text|hides the program window from view.}}
@ -352,7 +352,7 @@ __NOTOC__
* [[_SHELLHIDE]] (function) {{text|returns the code sent by a program exit using [[END]] or [[SYSTEM]] followed by an [[INTEGER]] value.}}
* [[_SHL]] (function) {{text|used to shift the bits of a numerical value to the left}}
* [[_SHR]] (function) {{text|used to shift the bits of a numerical value to the right.}}
* [[Mathematical_Operations|_SINH]] (function) {{text|Returns the hyperbolic sine of x radians.}}
* [[Mathematical_Operations|_SINH]] (function) {{text|returns the hyperbolic sine of x radians.}}
* [[_SNDBAL]] (statement) {{text|attempts to set the balance or 3D position of a sound file.}}
* [[_SNDCLOSE]] (statement) {{text|frees and unloads an open sound using the sound handle created by [[_SNDOPEN]].}}
* [[_SNDCOPY]] (function) {{text|copies a sound handle value to a new designated handle.}}
@ -388,7 +388,7 @@ __NOTOC__
<div id = "uT">_T</div>
* [[Mathematical_Operations|_TANH]] (function) {{text|Returns the hyperbolic tangent of x radians.}}
* [[Mathematical_Operations|_TANH]] (function) {{text|returns the hyperbolic tangent of x radians.}}
* [[_TITLE]] (statement) {{text|sets the program title [[STRING|string]] value.}}
* [[_TITLE$]] (function) {{text|gets the program title [[STRING|string]] value.}}
* [[_TOGGLEBIT]] (function) {{text|is used to toggle the specified bit of an integer variable from 1 to 0 or 0 to 1.}}

2
internal/help/Keywords_currently_not_supported_by_QB64.txt
View file

@ -20,7 +20,7 @@ The keywords listed here are not supported in QB64. QB64 is meant to be compatib
* [[OPEN]] with devices like '''LPT, CON, KBRD''', and other devices is not supported. [[LPRINT]] and [[OPEN COM]] are supported.
* ON PEN, PEN (statement), PEN (function)
* ON PLAY(n), PLAY(n) ON/OFF/STOP. ([[PLAY]] music is supported.)
* ON UEVENT
* ON UEVENT, UEVENT (statement)
* SETMEM
* SIGNAL
* TIME$ (statement) (reading the current [[TIME$]] is supported)

2
internal/help/LCASE$.txt
View file

@ -1,4 +1,4 @@
The [[LCASE$]] function outputs an all-lowercase version of a [[STRING]].
The [[LCASE$]] function returns an all-lowercase version of a [[STRING]].
{{PageSyntax}}

5
internal/help/LET.txt
View file

@ -2,13 +2,12 @@ The [[LET]] is a useless statement designed by [[cavemen]] when they started pro
{{PageSyntax}}
: '''[LET]''' {{Parameter|variable}} = {{Parameter|expression}}
: ['''LET'''] {{Parameter|variable}} = {{Parameter|expression}}
{{PageDescription}}
* {{InlineCode}}LET a = 12{{InlineCodeEnd}} is the same as {{InlineCode}}a = 12{{InlineCodeEnd}}, but wastes 4 extra bytes of program space.
''Notes:'' LET is '''optional''', it's the only keyword where the '''entire keyword''' is optional :-)
* [[LET]] is '''optional''', it's the only keyword where the '''entire keyword''' is optional :-)
{{PageSeeAlso}}

20
internal/help/LOG.txt
View file

@ -15,9 +15,9 @@ The [[LOG]] math function returns the natural logarithm of a specified numerical
{{PageExamples}}
''Example 1:'' [[FUNCTION]] to find the base ten logarithm of a numerical value.
{{CodeStart}}
FUNCTION Log10#(value AS DOUBLE) {{Cl|STATIC}}
Log10# = LOG(value) / LOG(10.#)
END FUNCTION '' ''
{{Cl|FUNCTION}} Log10#(value {{Cl|AS}} {{Cl|DOUBLE}}) {{Cl|STATIC}}
Log10# = {{Cl|LOG}}(value) / LOG(10.#)
{{Cl|END FUNCTION}} '' ''
{{CodeEnd}}
:''Explanation:'' The natural logarithm of the value is divided by the base 10 logarithm. The LOG of ten is designated as a DOUBLE precision return by using # after the Log10 value. The return tells you the number of times 10 goes into a value.
@ -25,13 +25,13 @@ The [[LOG]] math function returns the natural logarithm of a specified numerical
''Example 2:'' A binary FUNCTION to convert [[INTEGER]] values using LOG to find the number of digits the return will be.
{{CodeStart}} '' ''
FUNCTION BIN$ (n&)
IF n& < 0 THEN EXIT FUNCTION 'positive numbers only! negative error!
FOR p% = 0 TO INT({{Cl|LOG}}(n& + .1) / {{Cl|LOG}}(2)) ' added +.1 to get 0 to work
IF n& {{Cl|AND}} 2 ^ p% THEN s$ = "1" + s$ ELSE s$ = "0" + s$ 'find bits on
NEXT p%
IF s$ = "" THEN BIN$ = "&B0" ELSE BIN$ = "&B" + s$ 'check for zero return '' ''
END FUNCTION
{{Cl|FUNCTION}} BIN$ (n&)
{{Cl|IF}} n& < 0 {{Cl|THEN}} {{Cl|EXIT FUNCTION}} 'positive numbers only! negative error!
{{Cl|FOR}} p% = 0 {{Cl|TO}} {{Cl|INT}}({{Cl|LOG}}(n& + .1) / {{Cl|LOG}}(2)) 'added +.1 to get 0 to work
{{Cl|IF}} n& {{Cl|AND}} 2 ^ p% {{Cl|THEN}} s$ = "1" + s$ {{Cl|ELSE}} s$ = "0" + s$ 'find bits on
{{Cl|NEXT}} p%
{{Cl|IF}} s$ = "" {{Cl|THEN}} BIN$ = "&B0" {{Cl|ELSE}} BIN$ = "&B" + s$ 'check for zero return '' ''
{{Cl|END FUNCTION}}
{{CodeEnd}}
: ''Explanation:'' The LOG of a '''positive''' [[INTEGER]] value is divided by the LOG of 2 to determine the number of binary digits that will be returned. The FOR loop compares the value with the exponents of two and determines if a bit is ON or OFF as "1" or "0".

22
internal/help/MID$_(statement).txt
View file

@ -18,17 +18,17 @@ The [[MID$]] statement substitutes one or more new characters for existing chara
''Example:'' Using [[INSTR]] to locate the string positions and a [[MID$ (statement)|MID$]] statement to change the words.
{{CodeStart}}
text$ = "The cats and dogs were playing, even though dogs don't like cats."
PRINT text$
start% = 1 ' start cannot be 0 when used in the INSTR function!
{{Cl|DO...LOOP|DO}}
position% = {{Cl|INSTR}}(start%, text$, "dog")
IF position% THEN ' when position is a value greater than 0
{{Cl|MID$}}(text$, position%, 3) = "rat" ' changes "dog" to "rat" when found
start% = position% + 1 ' advance one position to search rest of string
END IF
LOOP UNTIL position% = 0 ' no other matches found
PRINT text$ '' ''
text$ = "The cats and dogs were playing, even though dogs don't like cats."
{{Cl|PRINT}} text$
start% = 1 ' start cannot be 0 when used in the INSTR function!
{{Cl|DO...LOOP|DO}}
position% = {{Cl|INSTR}}(start%, text$, "dog")
{{Cl|IF}} position% {{Cl|THEN}} ' when position is a value greater than 0
{{Cl|MID$}}(text$, position%, 3) = "rat" ' change "dog" to "rat" when found
start% = position% + 1 ' advance one position to search rest of string
{{Cl|END IF}}
{{Cl|LOOP}} {{Cl|UNTIL}} position% = 0 ' no other matches found
{{Cl|PRINT}} text$ '' ''
{{CodeEnd}}
{{OutputStart}}
The cats and dogs were playing, even though dogs don't like cats.

2
internal/help/MOD.txt
View file

@ -2,7 +2,7 @@ The [[MOD]] operator gives the remainder after division of one number by another
{{PageSyntax}}
: {{Parameter|remainder}} = {{Parameter|numerator}} [[MOD]] {{Parameter|divisor}}
:{{Parameter|remainder}} = {{Parameter|numerator}} [[MOD]] {{Parameter|divisor}}
{{PageParameters}}

31
internal/help/PRINT_USING.txt
View file

@ -1,4 +1,4 @@
The '''PRINT USING''' statement is used to [[PRINT]] formatted data to the Screen or a file using a [[STRING]] template.
The [[PRINT USING]] statement is used to [[PRINT]] formatted data to the Screen or a file using a [[STRING]] template.
{{PageSyntax}}
@ -9,22 +9,25 @@ The '''PRINT USING''' statement is used to [[PRINT]] formatted data to the Scree
* Literal or variable [[STRING]] ''text$'' can be placed between PRINT and USING or it can be included in the ''template''.
* A [[semicolon]] or [[comma]] may follow the ''text'' to stop or tab the print cursor before the ''template'' [[PRINT]].
* The literal or variable [[STRING]] ''template'' should use the template symbols to display each variable [[Variable Types|type]] in the list following it.
* The list of data ''variables'' used in the ''template'' are '''separated by semicolons''' after the template string value.
* In '''QB64''' ONE [[semicolon]] or [[comma]] may follow the variable list to stop the print cursor for pending prints. QB only allowed a semicolon.
* The list of data ''variables'' used in the ''template'' are separated by semicolons after the template string value.
* In QB64 one [[semicolon]] or [[comma]] may follow the variable list to stop the print cursor for pending prints. QB only allowed a semicolon.
{{PageDescription}}
* The ''variables'' should be listed in the order that they are used in the template from left to right.
* '''If the ''template'' string is omitted or symbols don't match the ''variable(s)'' an "Illegal Function Call" [[ERROR Codes|ERROR]] will occur!'''
* No more than 25 # digit places are allowed in a template number or an [[ERROR Codes|error]] will occur.
* If the ''template'' string is omitted or symbols don't match the ''variable(s)'' an "Illegal Function Call" [[ERROR Codes|ERROR]] will occur.
* Can convert numerical exponential or [[scientific notation]] values to normal decimal point values using less digits.
* '''NOTE:''' If the numerical value exceeds the template's digit range a % symbol will appear in the leftmost digit area.
* '''WARNING: The numbers displayed are rounded so the actual values are never changed and are actually more accurate.'''
* NOTE: If the numerical value exceeds the template's digit range a % symbol will appear in the leftmost digit area.
* WARNING: The numbers displayed are rounded so the actual values are never changed and are actually more accurate.
{{PrintUsing}}
{{PageQBasic}}
* QBasic limited the number of specified digit positions to 24; QB64 has no such restriction.
{{PageExamples}}
''Example 1:'' Printing formatted data using a predefined [[STRING|string]] template variable.
{{CodeStart}} '' ''
@ -40,15 +43,14 @@ tmp$ = "Salesperson: & & #####,. $$#####,.##"
''Example 2:'' How to display formatting symbols as normal text using underscores in a PRINT USING template.
{{CodeStart}} '' ''
{{CodeStart}}
errcode = 35
{{Cl|PRINT USING}} "Error ## occurred!!"; errcode
'now there are the !! at the end of the printed string
{{Cl|PRINT USING}} "Error ## occurred_!_!"; errcode
{{Cl|END}} ''
{{Cl|PRINT USING}} "Error ## occurred!"; errcode
'the ! is now displayed at the end of the printed string
{{Cl|PRINT USING}} "Error ## occurred_!"; errcode
{{CodeEnd}}
{{OutputStart}}Error 35 occurred
Error 35 occurred!!
Error 35 occurred!
{{OutputEnd}}
: ''Explanation:'' The first template will not print the exclamation points or error when the requested text parameters are omitted.
@ -75,6 +77,9 @@ tmp$ = "$$#######,.##"
{{Cl|PRINT}} "I have this much money!"; {{Cl|PRINT USING|USING}} tmp$; money '' ''
{{CodeEnd}}
{{OutputStart}}
I have this much money! $12,345.45
{{OutputEnd}}
: ''Note:'' This can also be used to print the USING formatting characters outside of the template.

40
internal/help/SQR.txt
View file

@ -1,19 +1,21 @@
The '''SQR''' function returns the square root of a numerical value.
The [[SQR]] function returns the square root of a numerical value.
{{PageSyntax}}
:: square_root = '''SQR('''value''')'''
:square_root = [[SQR]](value)
{{PageDescription}}
* The ''square root'' returned is normally a [[SINGLE]] or [[DOUBLE]] numerical value.
* The ''value'' parameter can be any '''positive''' numerical type. '''Negative parameter values will not work!'''
* Other exponential root functions can use fractional exponents([[^]]) enclosed in '''parenthesis only'''. EX: {{text|root <nowiki> = </nowiki> c ^ (a / b)|green}}
{{PageExamples}}
''Example 1:'' Finding the hypotenuse of a right triangle:
{{CodeStart}} '' ''
A% = 3: B% = 4
PRINT "hypotenuse! ="; SQR((A% ^ 2) + (B% ^ 2)) '' ''
{{Cl|PRINT}} "hypotenuse! ="; {{Cl|SQR}}((A% ^ 2) + (B% ^ 2)) '' ''
{{CodeEnd}}
{{OutputStart}}
hypotenuse = 5
@ -24,7 +26,7 @@ The '''SQR''' function returns the square root of a numerical value.
{{CodeStart}} '' ''
number = 8
cuberoot = number {{Cl|^}} (1/3)
PRINT cuberoot '' ''
{{Cl|PRINT}} cuberoot '' ''
{{CodeEnd}}
{{OutputStart}}
2
@ -35,7 +37,7 @@ The '''SQR''' function returns the square root of a numerical value.
{{CodeStart}} '' ''
number = 8
negroot = number {{Cl|^}} -2
PRINT negroot '' ''
{{Cl|PRINT}} negroot '' ''
{{CodeEnd}}
{{OutputStart}}
.015625
@ -45,21 +47,21 @@ The '''SQR''' function returns the square root of a numerical value.
''Example 4:'' Fast Prime number checker limits the numbers checked to the square root (half way).
{{CodeStart}}
DEFLNG P
DO
{{Cl|DEFLNG}} P
{{Cl|DO}}
PRIME = -1 'set PRIME as True
INPUT "Enter any number to check up to 2 million (Enter quits): ", guess$
{{Cl|INPUT}} "Enter any number to check up to 2 million (Enter quits): ", guess$
PR = {{Cl|VAL}}(guess$)
IF PR {{Cl|MOD}} 2 THEN 'check for even number
FOR P = 3 TO {{Cl|SQR}}(PR) STEP 2 'largest number that could be a multiple is the SQR
IF PR {{Cl|MOD}} P = 0 THEN PRIME = 0: EXIT FOR 'MOD = 0 when evenly divisible by another
NEXT
ELSE : PRIME = 0 'number to be checked is even so it cannot be a prime
END IF
IF PR = 2 THEN PRIME = -1 '2 is the ONLY even prime
IF PR = 1 THEN PRIME = 0 'MOD returns true but 1 is not a prime by definition
IF PRIME THEN PRINT "PRIME! How'd you find me? " ELSE PRINT "Not a prime, you lose!"
LOOP UNTIL PR = 0 '' ''
{{Cl|IF}} PR {{Cl|MOD}} 2 {{Cl|THEN}} 'check for even number
{{Cl|FOR}} P = 3 {{Cl|TO}} {{Cl|SQR}}(PR) {{Cl|STEP}} 2 'largest number that could be a multiple is the SQR
{{Cl|IF}} PR {{Cl|MOD}} P = 0 {{Cl|THEN}} PRIME = 0: {{Cl|EXIT FOR}} 'MOD = 0 when evenly divisible by another
{{Cl|NEXT}}
{{Cl|ELSE}} : PRIME = 0 'number to be checked is even so it cannot be a prime
{{Cl|END IF}}
{{Cl|IF}} PR = 2 {{Cl|THEN}} PRIME = -1 '2 is the ONLY even prime
{{Cl|IF}} PR = 1 {{Cl|THEN}} PRIME = 0 'MOD returns true but 1 is not a prime by definition
{{Cl|IF}} PRIME {{Cl|THEN}} {{Cl|PRINT}} "PRIME! How'd you find me? " {{Cl|ELSE}} {{Cl|PRINT}} "Not a prime, you lose!"
{{Cl|LOOP}} {{Cl|UNTIL}} PR = 0 '' ''
{{CodeEnd}}
{{OutputStart}}
Enter any number to check up to 2 million (Enter quits): 12379
@ -68,7 +70,7 @@ PRIME! How'd you find me?
<center>''Note:'' Prime numbers cannot be evenly divided by any other number except one.</center>
''See also:''
{{PageSeeAlso}}
*[[MOD]] {{text|(integer remainder division)}}
*[[^]] {{text|(exponential operator)}}
*[[Mathematical Operations]]

2
internal/help/UCASE$.txt
View file

@ -1,4 +1,4 @@
The [[UCASE$]] function outputs an all-uppercase version of a [[STRING]].
The [[UCASE$]] function returns an all-uppercase version of a [[STRING]].
{{PageSyntax}}

6
internal/help/Underscore.txt
View file

@ -1,13 +1,17 @@
An '''underscore''' can be used at the end of a line of code to continue a code line to the next line.
{{PageSyntax}}
''Usage:'' IF x + y > 500 AND x + y < 600 THEN_
::IF x + y > 500 AND x + y < 600 THEN_
:::PRINT x + y
{{PageDescription}}
* The underscore can be anywhere after the code on that line to continue the code to the next line in QB64.
* Multiple underscores can be used for the same line of code.
* Comments cannot follow an underscore and are not continued on the next line if they end in an underscore.
* Modern QB64 keywords are preceded by an underscore, unless [[$NOPREFIX]] is used. Variables and user procedures names cannot start with a single underscore.
** Variables and user procedures names can be preceded by double underscores if necessary.
* Underscores can be used in the middle of variable, sub procedure or [[CONST|constant]] names.

18
internal/help/VAL.txt
View file

@ -1,10 +1,11 @@
The '''VAL''' Function returns the decimal numerical equivalent value of a [[STRING]] numerical value.
The [[VAL]] Function returns the decimal numerical equivalent value of a [[STRING]] numerical value.
{{PageSyntax}}
:: value = VAL(string_value$)
:: value = [[VAL]](string_value$)
{{PageDescription}}
* VAL converts string numbers to numerical values including decimal point values and prefixed "[[&H]]" hexadecimal, "[[&O]]" octal.
* VAL conversion stops at non-numeric characters except for letter "D" or "E" exponential notation values.
:String values with "D" and "E" letters between numbers may be converted also! EX: '''{{text|VAL("9D4") <nowiki>=</nowiki> 90000|green}}'''
@ -16,6 +17,7 @@ The '''VAL''' Function returns the decimal numerical equivalent value of a [[STR
* In QB64 use an [[INTEGER]] return variable to hold integer values returned by VAL [[HEX$|Hex]] strings: '''{{text|value% <nowiki>= VAL("&HFFFF") =</nowiki> -1|green}}'''
{{PageExamples}}
''Example 1:'' Differences in values returned with QBasic and QB64:
{{CodeStart}} '' ''
{{Cl|PRINT}} {{Cl|VAL}}("{{Cl|&H}}") '203 in QB, 0 in QB64
@ -28,8 +30,8 @@ The '''VAL''' Function returns the decimal numerical equivalent value of a [[STR
''Example 2:'' Converting a string with some number characters
{{CodeStart}} '' ''
text$ = "1.23Hello"
number! = VAL(text$)
PRINT number! '' ''
number! = {{Cl|VAL}}(text$)
{{Cl|PRINT}} number! '' ''
{{CodeEnd}}
{{OutputStart}}
1.23
@ -39,7 +41,7 @@ The '''VAL''' Function returns the decimal numerical equivalent value of a [[STR
''Example 3:'' Converting literal and variable [[STRING|string]] values to numerical values.
{{CodeStart}} '' ''
a$ = "33"
PRINT VAL("10") + VAL(a$) + 1 '' ''
{{Cl|PRINT}} {{Cl|VAL}}("10") + {{Cl|VAL}}(a$) + 1 '' ''
{{CodeEnd}}
{{OutputStart}}
44
@ -55,9 +57,9 @@ The '''VAL''' Function returns the decimal numerical equivalent value of a [[STR
{{CodeStart}}
decnumber% = 96
hexnumber$ = "&H" + {{Cl|HEX$}}(decnumber%) 'convert decimal value to hex and add hex prefix
PRINT hexnumber$
{{Cl|PRINT}} hexnumber$
decimal% = {{Cl|VAL}}(hexnumber$)
PRINT decimal% '' ''
{{Cl|PRINT}} decimal% '' ''
{{CodeEnd}}
{{OutputStart}}
&H60
@ -66,7 +68,7 @@ The '''VAL''' Function returns the decimal numerical equivalent value of a [[STR
: ''Explanation:'' [[HEX$]] converts a decimal number to hexadecimal, but [[VAL]] will only recognize it as a valid value with the "&H" prefix. Especially since hexadecimal numbers can use "A" through "F" in them. Create a converter function from this code!
''See also:''
{{PageSeeAlso}}
* [[STR$]], [[HEX$]]
* [[OCT$]], [[ASC]]

12
internal/help/Variable.txt
View file

@ -1,8 +1,8 @@
A '''variable''' is a "container" name that can hold a numerical or string value which can be referenced or changed by the program (as opposed to [[CONST]]ant values which never change).
A '''variable''' is a named "container" that can hold a numerical or string value and which can be referenced or changed by the program (as opposed to [[CONST]]ant values which never change).
<center>'''Variable names'''</center>
Variables in QB64 can be any name except the names of QB64 or QBasic keywords and may not contain spaces or non-alphabetical/non-numerical characters (except "." and "_"). Numerical characters cannot be used as the first character of a variable or array name! '''QB64 reserves the use of a leading underscore to QB64 procedural or variable type names only!'''
Variables in QB64 can be any name except the names of QB64 or QBasic keywords and may not contain spaces or non-alphabetical/non-numerical characters (except "." and "_"). Numerical characters cannot be used as the first character of a variable or array name. QB64 reserves the use of a single leading underscore for QB64 procedural or variable type names.
Variable values can be passed to sub-procedures by using the name as a [[SUB]] or [[FUNCTION]] parameter in a [[CALL]]. Variable names in the main program module can be passed to sub-procedures by using [[DIM]] [[SHARED]] without using them as [[CALL]] parameters.
@ -28,15 +28,15 @@ Groups of variable names can be type defined by the first letter or list of lett
<center>'''Variable values'''</center>
All numerical variables default to 0 and all string variables default to "" at the start of a program and when first referenced inside of a [[SUB]] or [[FUNCTION]] procedure except when the variable is defined as a [[STATIC]] value.
Variables are initialized to empty values (0 for numerical values, and "" for strings) at the start of a program, or when first referenced inside of a [[SUB]] or [[FUNCTION]] call.
[[STATIC]] variables are also initialized to empty values, however, STATIC variables will retain their values in between SUB or FUNCTION calls, and exist for the life of the program.
[[Arrays]] variable names can hold many values in one variable name by specifying a reference index enclosed in parentheses.
[[STATIC]] sub-procedure values keep their value after the sub-procedure is exited. They will hold an empty value when first used.
Variables are used to hold program data information that is attained through the program flow, either by user input, calculations or by other ways of communicaton (as with I/O, memory, TCP/IP or files).

13
internal/help/^.txt
View file

@ -1,12 +1,11 @@
The '''^''' operation raises a numerical value to an exponential value expressing how many times the value is multiplied by itself.
The [[^]] operation raises a numerical value to an exponential value expressing how many times the value is multiplied by itself.
{{PageSyntax}}
::'' return_value = number '''^''' {whole_exponent|(fractional_exponent)}
:return_value = number [[^]] {whole_exponent|(fractional_exponent)}
{{PageDescription}}
* The number value can be any type literal or variable numerical value.
* Exponents can be any positive or negative integer or fractional numerical value inside of parenthesis brackets.
* If the exponent is zero, the value returned is 1.
@ -38,12 +37,8 @@ Enter a number to calculate it's cube root: 144
{{OutputEnd}}
''See also:''
[[SQR]], [[Mathematical Operations]]
{{PageSeeAlso}}
* [[SQR]], [[Mathematical Operations]]
{{PageNavigation}}

4
internal/help/_ACCEPTFILEDROP.txt
View file

@ -14,8 +14,8 @@ The [[_ACCEPTFILEDROP]] statement prepares a program window to receive files dro
* '''[[Keywords_currently_not_supported_by_QB64#Keywords_Not_Supported_in_Linux_or_MAC_OSX_versions|Keyword Not Supported in Linux or MAC versions]]'''.
==Availability==
* '''Version 1.3 and up'''.
{{PageAvailability}}
* Version 1.3 and up.
{{PageExamples}}

4
internal/help/_ACOS.txt
View file

@ -11,8 +11,8 @@ The [[_ACOS]] function returns the angle measured in radians based on an input [
* Note: Due to rounding with floating point math, the _ACOS may not always give a perfect match for the COS angle which generated this. You can reduce the number of rounding errors by increasing the precision of your calculations by using [[DOUBLE]] or [[_FLOAT]] precision variables instead of [[SINGLE]].
==Availability==
* '''Version 1.000 and up.'''
{{PageAvailability}}
* Version 1.000 and up.
{{PageExamples}}

4
internal/help/_ALLOWFULLSCREEN.txt
View file

@ -16,8 +16,8 @@ The [[_ALLOWFULLSCREEN]] statement allows setting the behavior of the ALT+ENTER
* With [[_ALLOWFULLSCREEN]] _OFF you can trap Alt+Enter manually in your program and reassign it. See example 2 below.
==Availability==
* '''Version 1.3 and up'''.
{{PageAvailability}}
* Version 1.3 and up.
{{PageExamples}}

4
internal/help/_ASIN.txt
View file

@ -12,8 +12,8 @@ The [[_ASIN]] function returns the angle measured in radians based on an input [
* Note: Due to rounding with floating point math, the [[_ASIN]] may not always give a perfect match for the [[SIN]] angle which generated this. You can reduce the number of rounding errors by increasing the precision of your calculations by using [[DOUBLE]] or [[_FLOAT]] precision variables instead of [[SINGLE]].
==Availability==
* '''Version 1.000 and up'''
{{PageAvailability}}
* Version 1.000 and up.
{{PageExamples}}

2
internal/help/_ASINH.txt
View file

@ -1,5 +1,5 @@
{{DISPLAYTITLE:_ASINH}}
The [[_ASINH]] returns the arc hyperbolic sine of x, expressed in radians.
The [[_ASINH]] function returns the arc hyperbolic sine of x, expressed in radians.
{{PageSyntax}}

4
internal/help/_ASSERT.txt
View file

@ -12,8 +12,8 @@ The [[_ASSERT]] statement can be used to perform tests in code that's in develop
* If the condition is not met (that is, if it evaluates to 0), an error occurs ("_ASSERT failed on line #") and program execution stops.
==Availability==
* '''Version 1.4 and up'''.
{{PageAvailability}}
* Version 1.4 and up.
{{PageExamples}}

4
internal/help/_AUTODISPLAY_(function).txt
View file

@ -11,8 +11,8 @@ The [[_AUTODISPLAY (function)|_AUTODISPLAY]] function returns the current displa
* If [[_DISPLAY]] is used, then [[_AUTODISPLAY (function)|_AUTODISPLAY]] returns 0, to indicate that screen changes (text or graphics) are only displayed per request, by calling [[_DISPLAY]] again to refresh the screen.
==Availability==
* '''Build 20170924/69'''.
{{PageAvailability}}
* Build 20170924/69 and up.
{{PageSeeAlso}}

4
internal/help/_BLINK.txt
View file

@ -13,8 +13,8 @@ The [[_BLINK]] statement toggles blinking colors in text mode (SCREEN 0). Defaul
* IF [[_DISPLAY]] is used, blinking is disabled, even if _BLINK is ON, but high intensity backgrounds aren't enabled in this case.
==Availability:==
* Build 20170816/61 up (August 16, 2017).
{{PageAvailability}}
* Build 20170816/61 and up).
{{PageExamples}}

4
internal/help/_BLINK_(function).txt
View file

@ -6,8 +6,8 @@ The [[_BLINK]] function returns the current blink setting for SCREEN 0 colors. I
: {{Parameter|blinkState%%}} = [[_BLINK]]
==Availability==
* Build 20170816/61 up (August 16, 2017).
{{PageAvailability}}
* Build 20170816/61 and up.
{{PageExamples}}

2
internal/help/_CAPSLOCK.txt
View file

@ -6,7 +6,7 @@ The [[_CAPSLOCK]] statement sets the state of the Caps Lock key.
: [[_CAPSLOCK]] {ON|OFF|_TOGGLE}
==Availability==
{{PageAvailability}}
* Version 1.4 and up.
* [[Keywords_currently_not_supported_by_QB64#Keywords_Not_Supported_in_Linux_or_MAC_OSX_versions|Not available in Linux or macOS]].

2
internal/help/_CAPSLOCK_(function).txt
View file

@ -6,7 +6,7 @@ The [[_CAPSLOCK (function)| _CAPSLOCK]] function returns the current state of th
: {{Parameter|keyStatus%%}} = [[_CAPSLOCK (function)| _CAPSLOCK]]
==Availability==
{{PageAvailability}}
* Version 1.4 and up.
* [[Keywords_currently_not_supported_by_QB64#Keywords_Not_Supported_in_Linux_or_MAC_OSX_versions|Not available in Linux or macOS]].

4
internal/help/_CEIL.txt
View file

@ -10,8 +10,8 @@ The [[_CEIL]] function rounds a numeric value up to the next whole number or [[I
* This means that [[_CEIL]] rounds up for both positive and negative numbers.
==Availability==
* '''Version 1.000 and up.'''
{{PageAvailability}}
* Version 1.000 and up.
{{PageExamples}}

4
internal/help/_CLIPBOARDIMAGE.txt
View file

@ -13,8 +13,8 @@ The [[_CLIPBOARDIMAGE]] statement copies a valid QB64 image to the clipboard.
* [[Keywords_currently_not_supported_by_QB64#Keywords_Not_Supported_in_Linux_or_MAC_OSX_versions|Not available in Linux or macOS]].
==Availability==
* '''Build 20170906/64''' onward.
{{PageAvailability}}
* Build 20170906/64 and up.
{{PageExamples}}

4
internal/help/_CLIPBOARDIMAGE_(function).txt
View file

@ -12,8 +12,8 @@ The [[_CLIPBOARDIMAGE (function)|_CLIPBOARDIMAGE]] function pastes an image from
* [[Keywords_currently_not_supported_by_QB64#Keywords_Not_Supported_in_Linux_or_MAC_OSX_versions|Not available in Linux or macOS]].
==Availability==
* '''Build 20170906/64''' onward.
{{PageAvailability}}
* Build 20170906/64 and up.
{{PageExamples}}

1
internal/help/_CONSOLEINPUT.txt
View file

@ -10,6 +10,7 @@ The [[_CONSOLEINPUT]] function is used to monitor any new mouse or keyboard inpu
* Returns 1 if new keyboard information is available, 2 if mouse information is available, otherwise it returns 0.
* Must be called before reading any of the other mouse functions and before reading [[_CINP]].
* To clear all previous input data, read [[_CONSOLEINPUT]] in a loop until it returns 0.
* To capture mouse input, turn off Quick Edit in the settings of command prompt and use [[_SOURCE]] [[_CONSOLE]].
* [[Keywords_currently_not_supported_by_QB64#Keywords_Not_Supported_in_Linux_or_MAC_OSX_versions|Not available in Linux or macOS]].

8
internal/help/_CONSOLETITLE.txt
View file

@ -1,13 +1,13 @@
{{DISPLAYTITLE:_CONSOLETITLE}}
The [[_CONSOLETITLE]] statement creates the title of the console window using a literal or variable [[STRING|string]].
The [[_CONSOLETITLE]] statement sets the console window's title-bar text.
{{PageSyntax}}
: [[_CONSOLETITLE]] {{Parameter|text$}}
{{PageDescription}}
* The ''text$'' used can be a literal or variable [[STRING]] value.
{{Parameters}}
* ''text$'' can be any literal or variable [[STRING]] value.
{{PageExamples}}
@ -23,7 +23,7 @@ The [[_CONSOLETITLE]] statement creates the title of the console window using a
{{Cl|END}}
{{CodeEnd}}
:''Note:'' You can also use [[SHELL]] "title consoletitle" to set the title of the console window. However, '''the recommended practice is to use [[_CONSOLETITLE]]'''.
:''Note:'' You can also use [[SHELL]] "title consoletitle" to set the title of the console window. However, the recommended practice is to use [[_CONSOLETITLE]].
''See also:''

4
internal/help/_CONTINUE.txt
View file

@ -7,8 +7,8 @@ The [[_CONTINUE]] statement is used in a [[DO...LOOP]], [[WHILE...WEND]] or [[FO
: [[_CONTINUE]]
==Availability==
* Build 20170628/55 up.
{{PageAvailability}}
* Build 20170628/55 and up.
{{PageExamples}}

4
internal/help/_D2G.txt
View file

@ -6,8 +6,8 @@ The [[_D2G]] function converts a '''degree''' value into a '''gradient''' value.
: {{Parameter|result}} = [[_D2G]]({{Parameter|num}})
==Availability==
* '''Version 1.000 and up.'''
{{PageAvailability}}
* Version 1.000 and up.
{{PageExamples}}

4
internal/help/_D2R.txt
View file

@ -6,8 +6,8 @@ The [[_D2R]] function converts a '''degree''' value into a '''radian''' value.
:: {{Parameter|result}} = [[_D2R]]({{Parameter|num}})
==Availability==
* '''Version 1.000 and up.'''
{{PageAvailability}}
* Version 1.000 and up.
{{PageExamples}}

4
internal/help/_DEFLATE$.txt
View file

@ -11,8 +11,8 @@ The [[_DEFLATE$]] function compresses a [[STRING|string]].
* To decompress the resulting string, use [[_INFLATE$]].
==Availability==
* '''Version 1.4 and up'''.
{{PageAvailability}}
* Version 1.4 and up.
{{PageExamples}}

9
internal/help/_DELAY.txt
View file

@ -1,14 +1,17 @@
{{DISPLAYTITLE:_DELAY}}
The [[_DELAY]] statement suspends program execution for a [[SINGLE]] value of seconds.
The [[_DELAY]] statement suspends program execution for the specified number of seconds.
{{PageSyntax}}
:[[_DELAY]] {{Parameter|seconds!}}
{{PageDescription}}
{{Parameters}}
* {{Parameter|seconds!}} is the time to wait, accurate to nearest millisecond (.001).
* While waiting, cpu cycles are relinquished to other applications.
{{PageDescription}}
* While waiting, CPU cycles are relinquished to other applications.
* Delays are not affected by midnight timer corrections.

4
internal/help/_DESKTOPHEIGHT.txt
View file

@ -11,8 +11,8 @@ The [[_DESKTOPHEIGHT]] function returns the height of the users current desktop.
* This returns the height of the user's desktop, not the size of any screen or window which might be open on that desktop.
==Availability==
* '''Version 1.000 and up.'''
{{PageAvailability}}
* Version 1.000 and up.
{{PageExamples}}

4
internal/help/_DESKTOPWIDTH.txt
View file

@ -11,8 +11,8 @@ The [[_DESKTOPWIDTH]] function returns the width of the users current desktop.
* This returns the width of the user's desktop, not the size of any screen or window which might be open on that desktop.
==Availability==
* '''Version 1.000 and up.'''
{{PageAvailability}}
* Version 1.000 and up.
{{PageExamples}}

4
internal/help/_DISPLAYORDER.txt
View file

@ -25,8 +25,8 @@ The [[_DISPLAYORDER]] statement defines the order to render software, hardware a
* Rendering the same content twice consecutively in a combination is not allowed.
==Availability==
* '''Version 1.000 and up.'''
{{PageAvailability}}
* Version 1.000 and up.
{{PageSeeAlso}}

4
internal/help/_DROPPEDFILE.txt
View file

@ -17,8 +17,8 @@ The [[_DROPPEDFILE]] function returns the list of items (files or folders) dropp
* '''[[Keywords_currently_not_supported_by_QB64#Keywords_Not_Supported_in_Linux_or_MAC_OSX_versions|Keyword Not Supported in Linux or MAC versions]]'''.
==Availability==
* '''Version 1.3 and up'''.
{{PageAvailability}}
* Version 1.3 and up.
{{PageExamples}}

4
internal/help/_ECHO.txt
View file

@ -11,8 +11,8 @@ The [[_ECHO]] statement allows outputting text to a [[$CONSOLE]] window without
* To output numbers, use the [[STR$]] function.
==Availability==
* '''Version 1.3 and up'''.
{{PageAvailability}}
* Version 1.3 and up.
{{PageExamples}}

4
internal/help/_FINISHDROP.txt
View file

@ -10,8 +10,8 @@ The [[_FINISHDROP]] statement resets [[_TOTALDROPPEDFILES]] and clears the [[_DR
* '''[[Keywords_currently_not_supported_by_QB64#Keywords_Not_Supported_in_Linux_or_MAC_OSX_versions|Keyword Not Supported in Linux or MAC versions]]'''.
==Availability==
* '''Version 1.3 and up'''.
{{PageAvailability}}
* Version 1.3 and up.
{{PageExamples}}

4
internal/help/_FONT_(function).txt
View file

@ -1,9 +1,9 @@
{{DISPLAYTITLE:_FONT (function)}}
The [[_FONT]] function retrieves the font handle from the specified image handle or the current [[_DEST]]ination page's font.
The [[_FONT (function)|_FONT]] function retrieves the font handle from the specified image handle or the current [[_DEST]]ination page's font.
{{PageSyntax}}
:{{Parameter|fontHandle&}} = [[_FONT]][({{Parameter|imageHandle&}})]
:{{Parameter|fontHandle&}} = [[_FONT (function)|_FONT]][({{Parameter|imageHandle&}})]
{{PageDescription}}

4
internal/help/_G2D.txt
View file

@ -6,8 +6,8 @@ The [[_G2D]] function converts a '''gradient''' value into a '''degree''' value.
: {{Parameter|result}} = [[_G2D]]({{Parameter|num}})
==Availability==
* '''Version 1.000 and up.'''
{{PageAvailability}}
* Version 1.000 and up.
{{PageExamples}}

4
internal/help/_G2R.txt
View file

@ -6,8 +6,8 @@ The [[_G2R]] function converts a '''gradient''' value into a '''radian''' value.
: {{Parameter|result}} = [[_G2R]]({{Parameter|num}})
==Availability==
* '''Version 1.000 and up.'''
{{PageAvailability}}
* Version 1.000 and up.
{{PageExamples}}

4
internal/help/_INCLERRORFILE$.txt
View file

@ -11,8 +11,8 @@ The [[_INCLERRORFILE$]] function returns the name of the original source code [[
If the last error occurred in the main module, [[_INCLERRORFILE$]] returns an empty string.
==Availability==
* '''Version 1.1 and up'''.
{{PageAvailability}}
* Version 1.1 and up.
{{PageExamples}}

4
internal/help/_INCLERRORLINE.txt
View file

@ -12,8 +12,8 @@ The [[_INCLERRORLINE]] function returns the line number in an [[$INCLUDE]] file
* By checking _INCLERRORLINE you can report exactly what line inside an included module caused the last error.
==Availability==
* '''Version 1.1 and up'''.
{{PageAvailability}}
* Version 1.1 and up.
{{PageExamples}}

4
internal/help/_INFLATE$.txt
View file

@ -12,8 +12,8 @@ The [[_INFLATE$]] function decompresses a [[STRING|string]] compressed by the [[
** If unspecified, decompression still works as expected, but may use more steps and need to allocate more memory internally.
==Availability==
* '''Version 1.4 and up'''.
{{PageAvailability}}
* Version 1.4 and up.
{{PageExamples}}

2
internal/help/_MEMSOUND.txt
View file

@ -19,7 +19,7 @@ The [[_MEMSOUND]] function returns a [[_MEM]] value referring to a sound's raw d
* If .SIZE returns 0, that means the data could not be accessed. It may happen if you try to access the right channel in a mono file, for example.
==Availability==
{{PageAvailability}}
* Version 1.5 and up.

6
internal/help/_MOUSEMOVE.txt
View file

@ -18,9 +18,9 @@ The [[_MOUSEMOVE]] statement moves the mouse pointer to a new position on the sc
* Does not require [[_MOUSEINPUT]] to be used, but all moves will be remembered and can be read by mouse functions.
==Availability==
* '''Versions prior to 1.000''' (Version 1.000 had this function disabled for compatibility reasons.)
* '''Version 1.1 and up'''
{{PageAvailability}}
* Versions prior to 1.000 (Version 1.000 had this function disabled for compatibility reasons).
* Version 1.1 and up.
{{PageExamples}}

2
internal/help/_NUMLOCK.txt
View file

@ -6,7 +6,7 @@ The [[_NUMLOCK]] statement sets the state of the Num Lock key.
: [[_NUMLOCK]] {ON|OFF|_TOGGLE}
==Availability==
{{PageAvailability}}
* Version 1.4 and up.
* [[Keywords_currently_not_supported_by_QB64#Keywords_Not_Supported_in_Linux_or_MAC_OSX_versions|Not available in Linux or macOS]].

2
internal/help/_NUMLOCK_(function).txt
View file

@ -6,7 +6,7 @@ The [[_NUMLOCK (function)| _NUMLOCK]] function returns the current state of the
: {{Parameter|keyStatus%%}} = [[_NUMLOCK (function)| _NUMLOCK]]
==Availability==
{{PageAvailability}}
* Version 1.4 and up.
* [[Keywords_currently_not_supported_by_QB64#Keywords_Not_Supported_in_Linux_or_MAC_OSX_versions|Not available in Linux or macOS]].

4
internal/help/_R2D.txt
View file

@ -6,8 +6,8 @@ The [[_R2D]] function converts a '''radian''' value into a '''degree''' value.
: {{Parameter|result!}} = [[_R2D]]({{Parameter|num}})
==Availability==
* '''Version 1.000 and up.'''
{{PageAvailability}}
* Version 1.000 and up.
{{PageExamples}}

4
internal/help/_R2G.txt
View file

@ -6,8 +6,8 @@ The [[_R2G]] function converts a '''radian''' value into a '''gradient''' value.
: {{Parameter|result!}} = [[_R2G]]({{Parameter|num}})
==Availability==
* '''Version 1.000 and up.'''
{{PageAvailability}}
* Version 1.000 and up.
{{PageExamples}}

4
internal/help/_READBIT.txt
View file

@ -17,8 +17,8 @@ The [[_READBIT]] function is used to check the state of a specified bit of a int
* Returns -1 if the bit is set(1), otherwise returns 0 if the bit is not set(0)
* Bits start at 0 (so a [[_BYTE]] has bits 0 to 7, [[INTEGER]] 0 to 15, and so on)
==Availability==
* '''Version 1.4 and up'''.
{{PageAvailability}}
* Version 1.4 and up.
{{PageExamples}}

4
internal/help/_RESETBIT.txt
View file

@ -17,8 +17,8 @@ The [[_RESETBIT]] function is used to set a specified bit of a numerical value t
* Resetting a bit that is already set to 0 will have no effect.
* Bits start at 0 (so a [[_BYTE]] has bits 0 to 7, [[INTEGER]] 0 to 15, and so on)
==Availability==
* '''Version 1.4 and up'''.
{{PageAvailability}}
* Version 1.4 and up.
{{PageExamples}}

4
internal/help/_RESIZEHEIGHT.txt
View file

@ -11,8 +11,8 @@ The [[_RESIZEHEIGHT]] function returns the user resized screen pixel height if [
* The program should decide if the request is allowable for proper program interaction.
==Availability==
* '''Version 1.000 and up'''.
{{PageAvailability}}
* Version 1.000 and up.
{{PageExamples}}

4
internal/help/_RESIZEWIDTH.txt
View file

@ -11,8 +11,8 @@ The [[_RESIZEWIDTH]] function returns the user resized screen pixel width if [[$
* The program should decide if the request is allowable for proper program interaction.
==Availability==
* '''Version 1.000 and up'''.
{{PageAvailability}}
* Version 1.000 and up.
{{PageExamples}}

4
internal/help/_RESIZE_(function).txt
View file

@ -12,8 +12,8 @@ The [[_RESIZE]] function returns true (-1) when a user has attempted to resize t
* The [[$RESIZE]]:ON [[metacommand]] must be used so the program is created with a user resizable window.
==Availability==
* '''Version 1.000 and up'''.
{{PageAvailability}}
* Version 1.000 and up.
{{PageExamples}}

4
internal/help/_RGB32.txt
View file

@ -32,8 +32,8 @@ The [[_RGB32]] function returns the 32-bit ''RGBA'' color value with specified r
* '''NOTE: Default 32-bit backgrounds are clear black or [[_RGB32]](0, 0). Use [[CLS]] to make the black opaque.'''
==Availability==
* Alternative syntaxes available with '''version 1.3 and up'''.
{{PageAvailability}}
* Alternative syntax available with version 1.3 and up.
{{PageExamples}}

2
internal/help/_SCREENEXISTS.txt
View file

@ -13,7 +13,7 @@ The [[_SCREENEXISTS]] function returns true (-1) once a screen has been created.
{{PageExamples}}
''Example:'' The loop waits until the screen exists to add the title.
''Example:'' The loop busy-waits until the screen exists to add the title.
{{CodeStart}} '' ''
{{Cl|SCREEN}} 12
{{Cl|DO}}: {{Cl|LOOP}} {{Cl|UNTIL}} _{{Cl|SCREENEXISTS}}

4
internal/help/_SCREENICON.txt
View file

@ -10,8 +10,8 @@ The [[_SCREENICON]] statement can be used to minimize the main program window to
* Use [[_SCREENICON]] to minimize the main program window to the taskbar.
==Availability==
* '''Version 1.000 and up'''.
{{PageAvailability}}
* Version 1.000 and up.
{{PageSeeAlso}}

2
internal/help/_SCROLLLOCK.txt
View file

@ -6,7 +6,7 @@ The [[_SCROLLLOCK]] statement sets the state of the Scroll Lock key.
: [[_SCROLLLOCK]] {ON|OFF|_TOGGLE}
==Availability==
{{PageAvailability}}
* Version 1.4 and up.
* [[Keywords_currently_not_supported_by_QB64#Keywords_Not_Supported_in_Linux_or_MAC_OSX_versions|Not available in Linux or macOS]].

2
internal/help/_SCROLLLOCK_(function).txt
View file

@ -6,7 +6,7 @@ The [[_SCROLLLOCK (function)| _SCROLLLOCK]] function returns the current state o
: {{Parameter|keyStatus%%}} = [[_SCROLLLOCK (function)| _SCROLLLOCK]]
==Availability==
{{PageAvailability}}
* Version 1.4 and up.
* [[Keywords_currently_not_supported_by_QB64#Keywords_Not_Supported_in_Linux_or_MAC_OSX_versions|Not available in Linux or macOS]].

4
internal/help/_SETBIT.txt
View file

@ -17,8 +17,8 @@ The [[_SETBIT]] function is used to set a specified bit of a numerical value to
* Setting a bit that is already set to 1 will have no effect.
* Bits start at 0 (so a [[_BYTE]] has bits 0 to 7, [[INTEGER]] 0 to 15, and so on)
==Availability==
* '''Version 1.4 and up'''.
{{PageAvailability}}
* Version 1.4 and up.
{{PageExamples}}

4
internal/help/_SHL.txt
View file

@ -19,8 +19,8 @@ The [[_SHL]] function is used to shift the bits of a numerical value to the left
* The type of variable used to store the results should match the type of the variable being shifted.
==Availability==
* '''Version 1.3 and up'''.
{{PageAvailability}}
* Version 1.3 and up.
{{PageExamples}}

4
internal/help/_SHR.txt
View file

@ -19,8 +19,8 @@ The [[_SHR]] function is used to shift the bits of a numerical value to the righ
* The type of variable used to store the results should match the type of the variable being shifted.
* NOTE: When dealing with SIGNED variables, shifting the bits right will leave the sign bit set. This is due to how C++ deals with bit shifting under the hood.
==Availability==
* '''Version 1.3 and up'''.
{{PageAvailability}}
* Version 1.3 and up.
{{PageExamples}}

4
internal/help/_SNDRAWDONE.txt
View file

@ -10,8 +10,8 @@
* Use to force playing small buffers of [[_SNDRAW]] data.
==Availability==
* '''Version 1.000 and up'''
{{PageAvailability}}
* Version 1.000 and up.
{{PageSeeAlso}}

4
internal/help/_STARTDIR$.txt
View file

@ -9,8 +9,8 @@ The [[_STARTDIR$]] function returns the path a user called a QB64 program from.
* Returns a [[STRING]] representing the user's program calling path.
==Availability==
* '''Version 1.000 and up'''.
{{PageAvailability}}
* Version 1.000 and up.
{{PageExamples}}

8
internal/help/_TITLE$.txt
View file

@ -1,5 +1,5 @@
{{DISPLAYTITLE:_TITLE$}}
The [[_TITLE$]] function returns the program title last set by the [[_TITLE]] statement.
The [[_TITLE$]] function returns the program window's title-bar text as last set by the [[_TITLE]] statement.
{{PageSyntax}}
@ -7,11 +7,11 @@ The [[_TITLE$]] function returns the program title last set by the [[_TITLE]] st
{{PageDescription}}
* If no title has been set, the title bar will say "Untitled" and this function will return an empty [[STRING|string]] ("").
* The title bar will display "Untitled" if no title has been set and this function will return an empty [[STRING|string]] ("").
==Availability==
* '''Build 20170924/68.'''
{{PageAvailability}}
* Build 20170924/68 and up.
{{PageSeeAlso}}

49
internal/help/_TITLE.txt
View file

@ -1,5 +1,5 @@
{{DISPLAYTITLE:_TITLE}}
The [[_TITLE]] statement provides the program name in the title bar of the program window.
The [[_TITLE]] statement sets the program window's title-bar text.
{{PageSyntax}}
@ -7,18 +7,17 @@ The [[_TITLE]] statement provides the program name in the title bar of the progr
{{PageParameters}}
* {{Parameter|text$}} can be any literal or variable [[STRING]] or [[ASCII]] character value.
* {{Parameter|text$}} can be any literal or variable [[STRING]] value.
{{PageDescription}}
* The title can be changed anywhere in a program procedure.
* The title bar will say "Untitled" if a title is not set.
* Change the title of the [[$CONSOLE]] windows created using [[_CONSOLETITLE]]
* '''Note: A [[_DELAY|delay]] may be required before the title can be set.''' See [[_SCREENEXISTS]].
* The title bar will display "Untitled" if a title is not set with this statement.
* The title of created [[$CONSOLE]] windows can be set using [[_CONSOLETITLE]].
* Note: A [[_DELAY|delay]] may be required before the title can be set. See [[_SCREENEXISTS]].
{{PageExamples}}
''Example 1:'' How to create the window title bar.
''Example 1:'' How to set the program window's title-bar text.
{{CodeStart}} '' ''
{{Cl|_TITLE}} "My New Program" '' ''
{{CodeEnd}}
@ -35,25 +34,25 @@ The [[_TITLE]] statement provides the program name in the title bar of the progr
{{Cl|FUNCTION}} TITLE$ '=== SHOW CURRENT PROGRAM
{{Cl|SHARED}} PATH$
{{Cl|DECLARE LIBRARY}} 'Directory Information using KERNEL32 provided by Dav
{{Cl|FUNCTION}} GetModuleFileNameA ({{Cl|BYVAL}} Module {{Cl|AS}} {{Cl|LONG}}, FileName {{Cl|AS}} {{Cl|STRING}}, {{Cl|BYVAL}} nSize {{Cl|AS}} {{Cl|LONG}})
{{Cl|DECLARE LIBRARY|END DECLARE}}
{{Cl|SHARED}} PATH$
{{Cl|DECLARE LIBRARY}} 'Directory Information using KERNEL32 provided by Dav
{{Cl|FUNCTION}} GetModuleFileNameA ({{Cl|BYVAL}} Module {{Cl|AS}} {{Cl|LONG}}, FileName {{Cl|AS}} {{Cl|STRING}}, {{Cl|BYVAL}} nSize {{Cl|AS}} {{Cl|LONG}})
{{Cl|DECLARE LIBRARY|END DECLARE}}
FileName$ = {{Cl|SPACE$}}(256)
Result = GetModuleFileNameA(0, FileName$, {{Cl|LEN}}(FileName$))
{{Cl|IF...THEN|IF}} Result {{Cl|THEN}}
PATH$ = {{Cl|LEFT$}}(FileName$, Result)
start = 1
DO
posit = {{Cl|INSTR}}(start, PATH$, "\")
{{Cl|IF...THEN|IF}} posit {{Cl|THEN}} last = posit
start = posit + 1
{{Cl|LOOP}} {{Cl|UNTIL}} posit = 0
TITLE$ = {{Cl|MID$}}(PATH$, last + 1)
PATH$ = {{Cl|LEFT$}}(PATH$, last)
{{Cl|ELSE}} TITLE$ = "": PATH$ = ""
{{Cl|END IF}}
FileName$ = {{Cl|SPACE$}}(256)
Result = GetModuleFileNameA(0, FileName$, {{Cl|LEN}}(FileName$))
{{Cl|IF...THEN|IF}} Result {{Cl|THEN}}
PATH$ = {{Cl|LEFT$}}(FileName$, Result)
start = 1
{{Cl|DO}}
posit = {{Cl|INSTR}}(start, PATH$, "\")
{{Cl|IF...THEN|IF}} posit {{Cl|THEN}} last = posit
start = posit + 1
{{Cl|LOOP}} {{Cl|UNTIL}} posit = 0
TITLE$ = {{Cl|MID$}}(PATH$, last + 1)
PATH$ = {{Cl|LEFT$}}(PATH$, last)
{{Cl|ELSE}} TITLE$ = "": PATH$ = ""
{{Cl|END IF}}
{{Cl|END FUNCTION}} '' ''
{{CodeEnd}}
: ''Note:'' The actual module file name is returned. Not necessarily the Title value. The value returned can be used however.

4
internal/help/_TOGGLEBIT.txt
View file

@ -17,8 +17,8 @@ The [[_TOGGLEBIT]] function is used to toggle a specified bit of a numerical val
* A bit set to 1 is changed to 0 and a bit set to 0 is changed to 1.
* Bits start at 0 (so a [[_BYTE]] has bits 0 to 7, [[INTEGER]] 0 to 15, and so on)
==Availability==
* '''Version 1.4 and up'''.
{{PageAvailability}}
* Version 1.4 and up.
{{PageExamples}}

4
internal/help/_TOTALDROPPEDFILES.txt
View file

@ -14,8 +14,8 @@ The [[_TOTALDROPPEDFILES]] function returns the number of items (files or folder
* '''[[Keywords_currently_not_supported_by_QB64#Keywords_Not_Supported_in_Linux_or_MAC_OSX_versions|Keyword Not Supported in Linux or MAC versions]]'''.
==Availability==
* '''Version 1.3 and up'''.
{{PageAvailability}}
* Version 1.3 and up.
{{PageExamples}}

4
internal/help/_WINDOWHANDLE.txt
View file

@ -12,8 +12,8 @@ The [[_WINDOWHANDLE]] function returns the window handle assigned to the current
* [[Keywords_currently_not_supported_by_QB64#Keywords_Not_Supported_in_Linux_or_MAC_OSX_versions|Not available in Linux or macOS]].
==Availability==
* '''Build 20170924/68'''.
{{PageAvailability}}
* Build 20170924/68 and up.
{{PageExamples}}

4
internal/help/_WINDOWHASFOCUS.txt
View file

@ -11,8 +11,8 @@ The [[_WINDOWHASFOCUS]] function returns true (-1) if the current program's wind
* [[Keywords_currently_not_supported_by_QB64#Keywords_Not_Supported_in_Linux_or_MAC_OSX_versions|Not available in macOS]].
==Availability==
* '''Build 20170924/68'''.
{{PageAvailability}}
* Build 20170924/68 and up.
{{PageExamples}}