[<<Previous Entry]
[^^Up^^]
[Next Entry>>]
[Menu]
[About The Guide]
SETBIT()
Sets one or more bits in a number
------------------------------------------------------------------------------
Syntax
SETBIT(<nLONG|cHexLONG>,<nBitPos1>,
[<nBitPos32>]) --> nNewValue
Arguments
<nLONG|cHexLONG> Designates either a decimal number or hexadecimal
number string.
<nBitPos1> ... <nBitPos32> Designates which bit numbers to
set.
Returns
SETBIT() sets the designated bits and returns the result.
Description
For example, SETBIT() allows you to set one or more bits to change a
serial interface register. This is in contrast to NUMOR(), where the
bit numbers can be set and do not need to be previously converted. The
value 1 represents the bit with the lowest value; 32 is the bit with the
highest value.
Note
. An invalid parameter returns a result of -1.
Example
Set bits 1, 2, and 5 in a numeric field:
nBitfield := 0
nBitfield := SETBIT(nBitfield, 1, 2, 5) // Result: 19
See Also:
NUMAND()
NUMNOT()
NUMOR()
NUMXOR()
ISBIT()
This page created by ng2html v1.05, the Norton guide to HTML conversion utility.
Written by Dave Pearson