Difference between revisions of "Bit (API)"

From ComputerCraft Wiki
Jump to: navigation, search
(Created page with "Lists:APIs")
 
m (Fixed grammatical error)
 
(22 intermediate revisions by 9 users not shown)
Line 1: Line 1:
[[Lists:APIs]]
+
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.bnot]]({{type|number}} n)|{{type|number}} value
 +
|Computes the bitwise NOT of a number.
 +
|odd}}
 +
 
 +
}}
 +
 
 +
 
 +
= Deprecated Functions =
 +
{{Deprecated
 +
|plural=yes
 +
|type=These functions
 +
}}
 +
 
 +
{{API table|Bit|image=Grid disk.png|2=
 +
 
 +
{{API table/row
 +
|[[bit.tobits]]({{type|number}} n)|{{type|table}} bit_tbl
 +
|Converts a number to an array (numerically-indexed table) containing the corresponding binary bit values.
 +
|odd}}
 +
 
 +
{{API table/row
 +
|[[bit.tonumb]]({{type|table}} bit_tbl)|{{type|number}} value
 +
|Converts an array (numerically-indexed table) of 0 and 1 values representing a number in binary into that number.
 +
|odd}}
 +
 
 +
}}
 +
 
 +
[[Category:APIs]]

Latest revision as of 01:23, 18 March 2014

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.

Grid disk.png  Bit (API)
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.bnot(number n) number value Computes the bitwise NOT of a number.


Deprecated Functions

These functions have been deprecated.
These functions have been removed from ComputerCraft .
Grid disk.png  Bit (API)
Function Return values Description
bit.tobits(number n) table bit_tbl Converts a number to an array (numerically-indexed table) containing the corresponding binary bit values.
bit.tonumb(table bit_tbl) number value Converts an array (numerically-indexed table) of 0 and 1 values representing a number in binary into that number.