TESTOFF

The TESTOFF function tests a specified bit in a binary number item to see whether it is off.

Syntax:

TESTOFF ( single-binary-number-expression , single-integer-expression )

Meaning:
TESTOFF ( binary_number_to_test , bit_to_test )
Returns:
"True" or "false"

The value of bit_to_test specifies which bit of binary_number_to_test should be tested for the value 0. If bit_to_test has the value 1, it refers to the leftmost bit of binary_number_to_test.

The TESTOFF function returns "true" if the specified bit is off and returns "false" if the specified bit is on.

If bit_to_test is less than one or greater than the number of bits of binary_number_to_test, TESTOFF returns "false".

Examples

  • TESTOFF (A, 16)

    Assume A is the two-byte binary value of "1", which is all zeros except for bit 16. The binary representation of the value in A is 0001.

    This example returns "false".

  • TESTOFF (A, 20)

    Returns "false" because bit 20 does not exist.