mirror of
https://github.com/QB64Official/qb64.git
synced 2024-08-22 03:15:07 +00:00
43 lines
1.2 KiB
Text
43 lines
1.2 KiB
Text
{{DISPLAYTITLE:_SETBIT}}
|
|
The [[_SETBIT]] function is used to set a specified bit of a numerical value to 1 (on state).
|
|
|
|
|
|
{{PageSyntax}}
|
|
:{{Parameter|result}} = [[_SETBIT]]({{Parameter|numericalVariable}}, {{Parameter|numericalValue}})
|
|
|
|
|
|
{{Parameters}}
|
|
* {{Parameter|numericalVariable}} is the variable to set the bit of and can be of the following types: [[_BYTE]], [[INTEGER]], [[LONG]], or [[_INTEGER64]].
|
|
* Integer values can be signed or [[_UNSIGNED]].
|
|
* {{Parameter|numericalValue}} the number of the bit to be set.
|
|
|
|
|
|
{{PageDescription}}
|
|
* Can be used to manually manipulate individual bits of an integer value by setting them to 1 (on state).
|
|
* 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'''.
|
|
|
|
|
|
{{PageExamples}}
|
|
''Example 1:''
|
|
{{CodeStart}}A~%% = 0 '{{Cl|_UNSIGNED}} {{Cl|_BYTE}}
|
|
{{Cl|PRINT}} A~%%
|
|
A~%% = {{Cl|_SETBIT}}(A~%%,6) 'set the seventh bit of A~%%
|
|
{{Cl|PRINT}} A~%%
|
|
{{CodeEnd}}
|
|
{{OutputStart}}
|
|
0
|
|
64
|
|
{{OutputEnd}}
|
|
|
|
|
|
|
|
{{PageSeeAlso}}
|
|
* [[_SHL]], [[_SHR]], [[INTEGER]], [[LONG]]
|
|
* [[_READBIT]], [[_BYTE]], [[_INTEGER64]]
|
|
* [[_RESETBIT]], [[_TOGGLEBIT]]
|
|
|
|
{{PageNavigation}}
|