Hi,

I tried addition and in-place addition on a list.

>>> l = ['a', 'b', 'c']

>>> l = l + 'de' (raises an error)

>>> l += 'de'
>>> print(l)
['a', 'b' , 'c', 'd', 'e']

I want to ask why the behaviour of both these are different?? If it is done intentionally, then it should be there in the documentation but I am not able to find any reference.

For those not in front of a computer, the error is:

>>> l = l + 'de'
Traceback (most recent call last):
  File "<stdin>", line 1, in <module>
TypeError: can only concatenate list (not "str") to list

https://docs.python.org/3/faq/programming.html#faq-augmented-assignment-tuple-error

> for lists, __iadd__ is equivalent to calling extend on the list and returning the list. That’s why we say that for lists, += is a “shorthand” for list.extend

This example is calling extend on list of strings with another string as argument. Hence the target string is iterated and each character is added as an element. __add__ is different compared __iadd__. For += __iadd__ is called if defined and falls back to __add__

Kapil, this behavior was intentional (not a bug), but later regarded as a design mistake.  GvR has said that if he had to do it over again list.__iadd__ would only accept other lists.  The problem arises when people write "somelist += 'hello'" and expect it to add a single string with one word rather than five one letter strings.  That said, the current behavior is guaranteed, people rely on it, and we cannot change it.

As Karthikeyan points out, this is documented.  However since the docs have grown so voluminous, it is often difficult to find any one particular fact.