GET BIT

Syntax

GET BIT bitpos OF byte_string INTO val.

Effect

This statement reads the bit at the bit position bitpos of the variable byte_string and assigns its value to the variable val.

The data object byte_string must be byte-type, while bitpos and val must be of data type i. The value of bitpos must be greater than 0, otherwise exceptions that cannot be handled will occur. The bit positions in byte_string are counted from the beginning of the data object. If the value of bitpos is greater than the number of bits in byte_string, not bit is read and sy-subrc is set to 4.

System Fields

sy-subrc	Meaning
0	The value of the bit at position bitpos of byte_string was placed in the result field val.
4	The value of bitpos is greater than the number of bits in byte_string and no bit was read

Notes

If byte_string is of the deep data type xstring, one bit is read from the referenced byte string and not from the reference.
In non-Unicode programs, you can also use character-type data objects for byte_string
The reading of single bits is especially intended for evaluating the results of bit expressions.

Example

The hexadecimal value 1B is assigned to the data object hex and its bits are read from front to back. The output is "00011011", which corresponds to the binary display of decimal 27 or hexadecimal 1B.

DATA: len TYPE i,
      res TYPE i,
      hex TYPE xstring.

hex = '1B'.
len =  XSTRLEN( hex ) * 8.

WHILE sy-index <= len.
  GET BIT sy-index OF hex INTO res.
  WRITE (1) res NO-GAP.
ENDWHILE.

Exceptions

Non-Catchable Exceptions

Cause: n is smaller than or equal to 0.
Runtime Error: BIT_OFFSET_NOT_POSITIVE