BITRESET

BITRESET resets the value of a specified bit in the local bit table to 0 and returns the value of the bit before it was changed.

 

COMMAND SYNTAX

BITRESET(table_no)

 

SYNTAX ELEMENTS

table_no specifies the position in the table of the bit to be reset. If table_no evaluates to zero, all elements in the table are reset to 0 (zero) and the returned value is zero.

 

NOTES

A unique table of 128 bits (numbered 1 to 128) is maintained for each process. Each bit in the table is treated as a two-state flag - the value returned will always be 0 (zero) or 1.

BITRESET returns the value of the bit before it was changed - checking and resetting a flag can be accomplished in one step.

BITRESET also provides some special functions if you use one of the following table_no values:

-1 resets the BREAK key Inhibit bit.
-2 resets the Command Level Restart feature.
-3 resets the Break/End Restart feature.

See also BITSET.

 

EXAMPLE

OLD.VALUE = BITRESET(112)
PRINT OLD.VALUE

If table entry 112 is 1, returns a value of 1, resets bit 112 to 0, and prints 1. If table entry 112 is 0, returns a value of 0, and prints 0.

jBC