<< Click to Display Table of Contents >> Navigation: 3. Script Language > BIT. - Work with Bits > BIT. - Work with Bits |
MiniRobotLanguage (MRL)
BIT.Get - check if Bit is set
Check if bit is set
Intention
Check if a specified Bit is set or cleared.
The parameters P1 and P2 can be given as value or as "binary".
The result is always "0" or "1" as a value. Please see ! Smart Package Robot 's BIT. - Operations
These two example below will check if Bit Nr.1 is set in the binary number "9" which is "1001".
Therefore the result will be a "1" in both Samples.
' Using a binary Number as Input
CHR.9|$$P01
VAN.$$P02=1
BIT.Get|b$$P01|$$P02|$$RES
MBX.$$RES
' Using a vale/numeric Number as Input
VAN.$$P01=9
VAN.$$P02=1
BIT.Get|$$P01|$$P02|$$RES
MBX.$$RES
Syntax
BIT.Get|[b/v]P1|[b/v]P2|P3[|P4]
Parameter Explanation
P1 - Variable containing a value or binary number. For example take the Number "9". It can be an ASC-Code "9" or the numeric number "9".
You can define this with a prefix of "v" for value and "b" for "binary". If the prefix is omitted, "v" is the default setting for P1.
P2 - Variable containing a value or binary number for the bit to get. Depending on P4 this number can be 1 to 8, 1 to 16 or 1 to 32. Unless "b" is prefixed the default type for P2 is "value".
P3 - Variable for result or "-". The result will always be numeric/value and can only be 1 or 0.
If omitted the result is placed on the TOS. Also here you can specify [b/v] for the format of the result. If you do not specify anything the result is "value"-Format.
P4 - optional, can be 1,2 or 4. Number of Bytes that are used internally. The number of Bits is the number of Bytes times 8.
1 - 8 Bits
2 - 16 Bits
4 - 32 Bits
Do not use the "8" Option. See Limitations below.
Example
'*****************************************************
' EXAMPLE 1:
'*****************************************************
VAN.$$P01=9
VAN.$$P02=4
VAN.$$SOL=1
BIT.Get|v$$P01|$$P02|$$ERG
MBX.$$ERG
END.
Remarks
-
Limitations:
When using the "|8" Parameter, the lower 4 bits are possibly wrong. This is not a bug its due to the way variables are stored internally.
Therefore we recommend to not use this option.
See also:
•3.5 Hexadezimal, Decimal and Binary and more
•VTH. - Variable to Hexadecimal
•CAL. - mathematical CALculation
•VAR. - Variable Set Value/Clear
•! Smart Package Robot 's BIT. - Operations
•BIT.16to8 - Split 1 Word into 2 Bytes
•BIT.16to32 - concatenate 2 Words to 32 Bit DWord
•BIT.32to16 - Split 1 DWord into 2 Words
•BIT.8to16 - concatenate 2 Bytes to 16 Bit Word
•BIT.AND - Use logical AND with Bits
•BIT.LShift - Shift Bits to Left, insert 0
•BIT.NOT - Use logical NOT with Bits
•BIT.OR - Use logical OR with Bits
•BIT.RotateLeft - Rotate Bits Left
•BIT.RotateRight - Rotate Bits Right
•BIT.RShift - Shift Bits to Right, insert 0
•BIT.Show - Show Bits in Binary-Numbers
•BIT.Store - Set Bit to 1 or 0
•BIT.ToBin - change Parameter to Binary-Format
•BIT.ToVal - change Parameter to Value-Format
•BIT.XOR - Use logical XOR with Bits
•BIT.Get - check if Bit is set
• CAL. - mathematical CALculation
• VAR. - Variable Set Value/Clear