$UNSTABLE: Difference between revisions

From QB64 Phoenix Edition Wiki
Jump to navigation Jump to search
(Add note about MIDI keyword deprecation.)
No edit summary
 
(4 intermediate revisions by 2 users not shown)
Line 8: Line 8:
{{PageParameters}}
{{PageParameters}}
* The current unstable features are as follows:
* The current unstable features are as follows:
** '''MIDI''' allows usage of the [[$MIDISOUNDFONT]] metacommand
** '''MIDI''' allows usage of the [[$MIDISOUNDFONT]] metacommand ({{Text|no longer required|red}}, see Availability below)
** '''HTTP''' allows opening HTTP connections using [[_OPENCLIENT]]
** '''HTTP''' allows opening HTTP connections using [[_OPENCLIENT]] ({{Text|no longer required|red}}, see Availability below)




Line 17: Line 17:
* Language features that become a permanent part of the language will no longer require [[$UNSTABLE]] to be used.
* Language features that become a permanent part of the language will no longer require [[$UNSTABLE]] to be used.
* More than one [[$UNSTABLE]] can be used in a program.
* More than one [[$UNSTABLE]] can be used in a program.
* MIDI keyword was deprecated in '''QB64-PE v3.14.0'''. Use [[_MIDISOUNDBANK]] instead.




Line 31: Line 30:
</gallery>
</gallery>
<!-- additional availability notes go below here -->
<!-- additional availability notes go below here -->
* MIDI keyword added in '''QB64-PE v3.2.0'''
* '''MIDI''' keyword added in '''QB64-PE v3.2.0'''
* HTTP keyword added in '''QB64-PE v3.5.0'''
* '''HTTP''' keyword added in '''QB64-PE v3.5.0'''
* '''MIDI''' keyword {{Text|no longer required|red}}, MIDI support is stable since '''QB64-PE v3.14.0'''. See [[_MIDISOUNDBANK]].
* '''HTTP''' keyword {{Text|no longer required|red}}, HTTP support is stable since '''QB64-PE v4.0.0'''. The [[_OPENCLIENT]] HTTP syntax is usable at any time now.




Line 47: Line 48:


{{PageSeeAlso}}
{{PageSeeAlso}}
* [[$MIDISOUNDFONT]]
* [[$MIDISOUNDFONT]] ({{Text|deprecated|red}})
* [[_MIDISOUNDBANK]]
* [[_OPENCLIENT]]
* [[_OPENCLIENT]]




{{PageNavigation}}
{{PageNavigation}}

Latest revision as of 21:25, 17 November 2024

The $UNSTABLE metacommand is used to enable the use of features that have not yet been made a permanent part of the language. Features hidden behind this metacommand may have breaking changes or be removed between releases.


Syntax

$UNSTABLE: {MIDI, HTTP}


Parameters

  • The current unstable features are as follows:
    • MIDI allows usage of the $MIDISOUNDFONT metacommand (no longer required, see Availability below)
    • HTTP allows opening HTTP connections using _OPENCLIENT (no longer required, see Availability below)


Description

  • $UNSTABLE exists as a way to allow usage of new language features before they are finalized as part of the language.
  • Any languages features hidden behind $UNSTABLE may be changed in breaking ways in the next version of QB64-PE.
  • Language features that become a permanent part of the language will no longer require $UNSTABLE to be used.
  • More than one $UNSTABLE can be used in a program.


Availability

  • MIDI keyword added in QB64-PE v3.2.0
  • HTTP keyword added in QB64-PE v3.5.0
  • MIDI keyword no longer required, MIDI support is stable since QB64-PE v3.14.0. See _MIDISOUNDBANK.
  • HTTP keyword no longer required, HTTP support is stable since QB64-PE v4.0.0. The _OPENCLIENT HTTP syntax is usable at any time now.


Examples

$UNSTABLE:MIDI

' This line is only allowed when $UNSTABLE:MIDI is used
$MIDISOUNDFONT: Default

_SNDPLAYFILE "example.mid"


See also



Navigation:
Main Page with Articles and Tutorials
Keyword Reference - Alphabetical
Keyword Reference - By usage
Report a broken link