Difference between revisions of "Bit (API)"
From ComputerCraft Wiki
m (Int -> {{type|number}}) |
|||
| Line 1: | Line 1: | ||
The Bit API is for manipulating numbers using bitwise binary operations. | The Bit API is for manipulating numbers using bitwise binary operations. | ||
| − | + | All of these functions treat the numbers as 32-bit integers, and will raise an error if an input number is greater than 4,294,967,295. | |
| − | + | ||
| − | + | {{API table|Bit|image=Grid disk.png|2= | |
| − | + | {{API table/row | |
| − | + | |[[bit.blshift]]({{type|number}} n, {{type|number}} bits)|{{type|number}} value | |
| − | + | |Shifts a number left by a specified number of bits. | |
| + | |odd}} | ||
| − | + | {{API table/row | |
| − | + | |[[bit.brshift]]({{type|number}} n, {{type|number}} bits)|{{type|number}} value | |
| − | + | |Shifts a number right arithmetically by a specified number of bits. | |
| + | |}} | ||
| − | + | {{API table/row | |
| − | + | |[[bit.blogic_rshift]]({{type|number}} n, {{type|number}} bits)|{{type|number}} value | |
| − | + | |Shifts a number right logically by a specified number of bits. | |
| + | |odd}} | ||
| − | + | {{API table/row | |
| − | + | |[[bit.bxor]]({{type|number}} m, {{type|number}} n)|{{type|number}} value | |
| − | + | |Computes the bitwise exclusive OR of two numbers. | |
| + | |}} | ||
| − | + | {{API table/row | |
| − | + | |[[bit.bor]]({{type|number}} m, {{type|number}} n)|{{type|number}} value | |
| − | + | |Computes the bitwise inclusive OR of two numbers. | |
| + | |odd}} | ||
| − | + | {{API table/row | |
| − | + | |[[bit.band]]({{type|number}} m, {{type|number}} n)|{{type|number}} value | |
| − | + | |Computes the bitwise AND of two numbers. | |
| + | |}} | ||
| − | + | {{API table/row | |
| − | + | |[[bit.band]]({{type|number}} n)|{{type|number}} value | |
| − | + | |Computes the bitwise NOT of a numbers. | |
| − | + | |odd}} | |
| + | |||
| + | }} | ||
Revision as of 03:07, 25 August 2013
The Bit API is for manipulating numbers using bitwise binary operations.
All of these functions treat the numbers as 32-bit integers, and will raise an error if an input number is greater than 4,294,967,295.
|
| ||
|---|---|---|
| Function | Return values | Description |
| bit.blshift(number n, number bits) | number value | Shifts a number left by a specified number of bits. |
| bit.brshift(number n, number bits) | number value | Shifts a number right arithmetically by a specified number of bits. |
| bit.blogic_rshift(number n, number bits) | number value | Shifts a number right logically by a specified number of bits. |
| bit.bxor(number m, number n) | number value | Computes the bitwise exclusive OR of two numbers. |
| bit.bor(number m, number n) | number value | Computes the bitwise inclusive OR of two numbers. |
| bit.band(number m, number n) | number value | Computes the bitwise AND of two numbers. |
| bit.band(number n) | number value | Computes the bitwise NOT of a numbers. |
Deprecated Functions
| These functions have been deprecated. These functions have been removed from ComputerCraft .
|
| Return | Method name | Description |
| table bit_tbl | bit.tobits(number n) | Converts a number to an array (numerically-indexed table) containing the corresponding binary bit values. |
| number value | bit.tonumb(table bit_tbl) | Converts an array (numerically-indexed table) of 0 and 1 values representing a number in binary into that number. |