mirrors/cpython
1
0
Fork 0
mirror of https://github.com/python/cpython.git synced 2025-11-03 03:22:27 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions 8

1. Clarify that immutability isn't entirely the same as unchangeable

Browse source 
value (because of immutable containers containing mutable objects).

2. Document that func_code, func_defaults and func_doc / __doc__ are
now writable.
This commit is contained in:
Guido van Rossum 1999-02-23 16:40:55 +00:00
parent 124eff0225
commit 264bd59221
1 changed files with 12 additions and 2 deletions
Download patch file Download diff file Expand all files Collapse all files

14
Doc/ref/ref3.tex
View file

@ -24,6 +24,12 @@ possible values for objects of that type. The
objects can change. Objects whose value can change are said to be objects can change. Objects whose value can change are said to be
\emph{mutable}; objects whose value is unchangeable once they are \emph{mutable}; objects whose value is unchangeable once they are
created are called \emph{immutable}. created are called \emph{immutable}.
(The value of an immutable container object that contains a reference
to a mutable object can change when the latter's value is changed;
however the container is still considered immutable, because the
collection of objects it contains cannot be changed. So, immutability
is not strictly the same as having an unchangeable value, it is more
subtle.)
An object's mutability is determined by its type; for instance, An object's mutability is determined by its type; for instance,
numbers, strings and tuples are immutable, while dictionaries and numbers, strings and tuples are immutable, while dictionaries and
lists are mutable. lists are mutable.
@ -375,7 +381,7 @@ parameter list.
\obindex{function} \obindex{function}
\obindex{user-defined function} \obindex{user-defined function}
Special read-only attributes: \member{func_doc} or \member{__doc__} is the Special attributes: \member{func_doc} or \member{__doc__} is the
function's documentation string, or None if unavailable; function's documentation string, or None if unavailable;
\member{func_name} or \member{__name__} is the function's name; \member{func_name} or \member{__name__} is the function's name;
\member{func_defaults} is a tuple containing default argument values for \member{func_defaults} is a tuple containing default argument values for
@ -384,7 +390,11 @@ have a default value; \member{func_code} is the code object representing
the compiled function body; \member{func_globals} is (a reference to) the compiled function body; \member{func_globals} is (a reference to)
the dictionary that holds the function's global variables --- it the dictionary that holds the function's global variables --- it
defines the global namespace of the module in which the function was defines the global namespace of the module in which the function was
defined. Additional information about a function's definition can be defined.
Of these, \member{func_code}, \member{func_defaults} and
\member{func_doc} (and this \member{__doc__}) may be writable; the
others can never be changed.
Additional information about a function's definition can be
retrieved from its code object; see the description of internal types retrieved from its code object; see the description of internal types
below. below.
\withsubitem{(function attribute)}{ \withsubitem{(function attribute)}{