Commitdd3fe99

authored

Clarify how you would end up with None in programming.rst

Assigning `y.sort()` to a variable clarifies why you would end up with a `None`.

1 parent0ff1611 commitdd3fe99Copy full SHA for dd3fe99

File tree

-1

lines changed

-1

lines changed

Lines changed: 1 addition & 1 deletion

Original file line number	Diff line number	Diff line change
@@ -481,7 +481,7 @@ object, whereas superficially similar operations (for example ``y = y + [10]``
`481`	`481`	and:func:`sorted(y) <sorted>`) create a new object. In general in Python (and in all cases
`482`	`482`	in the standard library) a method that mutates an object will return ``None``
`483`	`483`	`to help avoid getting the two types of operations confused. So if you`
`484`		-mistakenly write ``y.sort()`` thinking it will give you a sorted copy of ``y``,
	`484`	+mistakenly write ``z=y.sort()`` thinking it will give you a sorted copy of ``y``,
`485`	`485`	you'll instead end up with ``None``, which will likely cause your program to
`486`	`486`	`generate an easily diagnosed error.`
`487`	`487`

Comments

(0)