ROR: Difference between revisions

From QB64 Phoenix Edition Wiki
Jump to navigation Jump to search
m (Change "shift" to "rotate")
No edit summary
Line 19: Line 19:




==Availability==
{{PageAvailability}}
* '''Version 3.1.0 and up'''.
* '''QB64-PE v3.1 and up''' (QB64 Phoenix Edition)





Revision as of 21:45, 3 September 2022

The _ROR function is used to rotate the bits of a numerical value to the right. A rotation (or circular shift) is an operation similar to shift (_SHL and _SHR) except that the bits that fall off at one end are put back to the other end.


Syntax

result = _ROR(numericalVariable, numericalValue)


Template:Parameters

  • numericalVariable is the variable to shift the bits of and can be of the following types: _BYTE, INTEGER, LONG, or _INTEGER64.
  • Integer values can be signed or _UNSIGNED.
  • numericalValue is the number of places to rotate the bits.
  • While 0 is a valid value it will have no affect on the variable being rotated.


Description

  • In right rotation, the bits that fall off at right end are put back at left end.
  • The type of variable used to store the results should match the type of the variable being shifted.


Availability

  • QB64-PE v3.1 and up (QB64 Phoenix Edition)


Examples

OPTION _EXPLICIT

DIM a AS _UNSIGNED _BYTE
DIM b AS _UNSIGNED INTEGER
DIM c AS _UNSIGNED LONG
DIM d AS _UNSIGNED _INTEGER64

a = &B11110000
b = &B1111111100000000
c = &B11111111111111110000000000000000
d = &B1111111111111111111111111111111100000000000000000000000000000000

DO
    a = _ROR(a, 1)
    b = _ROR(b, 1)
    c = _ROR(c, 1)
    d = _ROR(d, 1)

    LOCATE 1, 1: PRINT RIGHT$(STRING$(8, "0") + _BIN$(a), 8);
    LOCATE 2, 1: PRINT RIGHT$(STRING$(16, "0") + _BIN$(b), 16);
    LOCATE 3, 1: PRINT RIGHT$(STRING$(32, "0") + _BIN$(c), 32);
    LOCATE 4, 1: PRINT RIGHT$(STRING$(64, "0") + _BIN$(d), 64);

    _LIMIT 15
LOOP WHILE _KEYHIT <> 27


See also



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