[docs] Bugs in Python3 division and right-shift docs
Georg Brandl
georg at python.org
Tue Oct 8 21:47:53 CEST 2013
-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1
Am 27.02.2013 21:30, schrieb Albert Hofkamp:
> While reporting a doc bug in the right-shift operator, I found another one
> in the division description. I combined them both below.
>
>
> http://docs.python.org/3/reference/expressions.html?highlight=shift#binary-arithmetic-operations
>
>
A quote:
> " ... The / (division) and // (floor division) operators yield the quotient
> of their arguments. The numeric arguments are first converted to a common
> type. Integer division yields a float, while floor division of integers
> results in an integer; ..."
>
> The term "Integer division" does not get defined here. Perhaps "Division
> of integers yields ..." would be better?
>
>
>
>
> http://docs.python.org/3/reference/expressions.html?highlight=shift#shifting-operations
>
>
A quote from 6.7 (Shifting operations) of the python 3 language reference:
>
> "...These operators accept integers as arguments. They shift the first
> argument to the left or right by the number of bits given by the second
> argument. A right shift by n bits is defined as division by pow(2,n). A
> left shift by n bits is defined as multiplication with pow(2,n). ..."
>
> By the latter sentence, I can interpret 2 >> 5 as 2 / pow(2, 5), which is
> 0.0625. On the other hand, 2 >> 5 is 0 according to Python 3.3 . Perhaps it
> should say "floor division" in the explanation above?
Hi Albert,
thanks for the suggestions; they are now incorporated and will appear online soon.
cheers,
Georg
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v2.0.21 (GNU/Linux)
iEYEARECAAYFAlJUYWkACgkQN9GcIYhpnLCUIgCfYrbCI+vObbGEORuxrp/4pX0L
LcIAoK76JLT+lOXHVydTBul6heKUcMv3
=xNMa
-----END PGP SIGNATURE-----
More information about the docs
mailing list