SetBit

Sets a single bit in an Integer tag to 1.

Function Group Execution Windows Embedded Thin Client
SetBit Arithmetic Synchronous Supported Supported Supported

Syntax

SetBit( tagName, numBitNumber )
tagName
The name of an Integer tag where the bit value will be set.
Note: To directly specify the name of a tag, rather than take the value of the tag, you must enclose the tag name in double-quotes. For example, SetBit( "Second", 1 ).
numBitNumber
A numeric tag or value specifying the position (0…31) of the bit to set.

Returned value

0 No error
1 Invalid parameter
2 Tag does not exist

Notes

You can also use the Bit field to read/write values from specific bits of an integer tag. For example, enter Second->b0 to access the LSB (Least Significant Bit of the Second tag), and Second->b31 to access the MSB (Most Significant Bit of the Second tag).

Examples

Tag Name Expression
Tag GetBit( "numSource", 4 ) // If the tag numSource held a value of 0, then this function returns 0 and numSource holds a new value of 16.
Tag GetBit( "numSource", 1 ) // If the tag numSource held the value 17, then this function returns 0 and numSource holds a new value of 19.