3448
Comment:

← Revision 11 as of 20130706 12:54:41 ⇥
3460

Deletions are marked like this.  Additions are marked like this. 
Line 5:  Line 5: 
All of these operators share something in common  they are "bitwise" operators. That is, they operate on numbers (normally), but instead of treating that number as if it were a single value, they treat it as if it were a string of bits, written in twoscomplement binary. A two's complement binary is same as the classical binary representation for positve integers but is slightly different for negative numbers. Negative numbers are represented by performing the [[http://en.wikipedia.org/wiki/Two%27s_complementtwo's complement]] operation on their absolute value. So a brief summary of twoscomplement binary is in order:  All of these operators share something in common  they are "bitwise" operators. That is, they operate on numbers (normally), but instead of treating that number as if it were a single value, they treat it as if it were a string of bits, written in twoscomplement binary. A two's complement binary is same as the classical binary representation for positve integers but is slightly different for negative numbers. Negative numbers are represented by performing the [[http://en.wikipedia.org/wiki/Two's_complementtwo's complement]] operation on their absolute value. So a brief summary of twoscomplement binary is in order: 
Line 7:  Line 7: 
Two's Complement binary for Positive Integers:  '''Two's Complement binary for Positive Integers: ''' 
Line 20:  Line 20: 
Two's Complement binary for Negative Integers:  '''Two's Complement binary for Negative Integers: ''' 
FAQ: What do the operators <<, >>, &, , ~, and ^ do?
These are Python's bitwise operators.
Preamble: TwosComplement Numbers
All of these operators share something in common  they are "bitwise" operators. That is, they operate on numbers (normally), but instead of treating that number as if it were a single value, they treat it as if it were a string of bits, written in twoscomplement binary. A two's complement binary is same as the classical binary representation for positve integers but is slightly different for negative numbers. Negative numbers are represented by performing the two's complement operation on their absolute value. So a brief summary of twoscomplement binary is in order:
Two's Complement binary for Positive Integers:
 0 is written as "0"
 1 is written as "1"
 2 is written as "10"
 3 is "11"
 4 is "100"
 5 is "101"
 .
 .
 1029 is "10000000101" == 2**10 + 2**2 + 2**0 == 1024 + 4 + 1
Two's Complement binary for Negative Integers:
Negative numbers are written with a leading one instead of a leading zero. So if you are using only 8 bits for your twoscomplement numbers, then you treat patterns from "00000000" to "01111111" as the whole numbers from 0 to 127, and reserve "1xxxxxxx" for writing negative numbers. A negative number, x, is written using the bit pattern for (x1) with all of the bits complemented (switched from 1 to 0 or 0 to 1). So 1 is complement(1  1) = complement(0) = "11111111", and 10 is complement(10  1) = complement(9) = complement("00001001") = "11110110". This means that negative numbers go all the way down to 128 ("10000000").
Of course, Python doesn't use 8bit numbers. It USED to use however many bits were native to your machine, but since that was nonportable, it has recently switched to using an INFINITE number of bits. Thus the number 5 is treated by bitwise operators as if it were written "...1111111111111111111011".
Whew! With that preamble out of the way (and hey, you probably knew this already), the operators are easy to explain:
The Operators:
 x << y
 Returns x with the bits shifted to the left by y places (and new bits on the righthandside are zeros). This is the same as multiplying x by 2**y.
 x >> y
 Returns x with the bits shifted to the right by y places. This is the same as //'ing x by 2**y.
 x & y
 Does a "bitwise and". Each bit of the output is 1 if the corresponding bit of x AND of y is 1, otherwise it's 0.
 x  y
 Does a "bitwise or". Each bit of the output is 0 if the corresponding bit of x AND of y is 0, otherwise it's 1.
 ~ x
 Returns the complement of x  the number you get by switching each 1 for a 0 and each 0 for a 1. This is the same as x  1.
 x ^ y
 Does a "bitwise exclusive or". Each bit of the output is the same as the corresponding bit in x if that bit in y is 0, and it's the complement of the bit in x if that bit in y is 1.
Just remember about that infinite series of 1 bits in a negative number, and these should all make sense.
Other Classes
One more point: Python allows operator overloading, so some classes may be written to allow the bitwise operators, but with some other meaning. For instance, the new sets module for Python 2.3 uses  and & for union and intersection.