$UNSTABLE: Difference between revisions

From QB64 Phoenix Edition Wiki
Jump to navigation Jump to search
No edit summary
No edit summary
 
(7 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 20: Line 20:


{{PageAvailability}}
{{PageAvailability}}
<!-- QB64 = a version or none, QBPE = a version or all, Platforms = yes or no -->
<gallery widths="48px" heights="48px" mode="nolines">
<gallery widths="48px" heights="48px" mode="nolines">
File:Qb64.png|'''none'''
File:Qb64.png|'''none'''
Line 28: Line 29:
File:Osx.png|'''yes'''
File:Osx.png|'''yes'''
</gallery>
</gallery>
 
<!-- 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 37: Line 40:
{{Cl|$UNSTABLE}}:MIDI
{{Cl|$UNSTABLE}}:MIDI


' This line is only allowed when {{cl|$UNSTABLE}}:MIDI is used
' This line is only allowed when {{Cl|$UNSTABLE}}:MIDI is used
{{cl|$MIDISOUNDFONT}}: Default
{{Cl|$MIDISOUNDFONT}}: Default


{{cl|_SNDPLAYFILE}} "example.mid"
{{Cl|_SNDPLAYFILE}} "example.mid"
{{CodeEnd}}
{{CodeEnd}}




{{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