Added cross-references plus a note about dict & list shallow copying.

This commit is contained in:
Mark Summerfield 2007-09-04 08:16:15 +00:00
parent 691632f14d
commit fcb444a8bf
5 changed files with 15 additions and 6 deletions

View File

@ -54,6 +54,10 @@ file, socket, window, array, or any similar types. It does "copy" functions and
classes (shallow and deeply), by returning the original object unchanged; this classes (shallow and deeply), by returning the original object unchanged; this
is compatible with the way these are treated by the :mod:`pickle` module. is compatible with the way these are treated by the :mod:`pickle` module.
Shallow copies of dictionaries can be made using :meth:`dict.copy`, and
of lists by assigning a slice of the entire list, for example,
``copied_list = original_list[:]``.
.. versionchanged:: 2.5 .. versionchanged:: 2.5
Added copying functions. Added copying functions.

View File

@ -8,8 +8,9 @@
The :mod:`mutex` module defines a class that allows mutual-exclusion via The :mod:`mutex` module defines a class that allows mutual-exclusion via
acquiring and releasing locks. It does not require (or imply) threading or acquiring and releasing locks. It does not require (or imply)
multi-tasking, though it could be useful for those purposes. :mod:`threading` or multi-tasking, though it could be useful for those
purposes.
The :mod:`mutex` module defines the following class: The :mod:`mutex` module defines the following class:

View File

@ -7,10 +7,11 @@
The :mod:`Queue` module implements a multi-producer, multi-consumer FIFO queue. The :mod:`Queue` module implements a multi-producer, multi-consumer FIFO queue.
It is especially useful in threads programming when information must be It is especially useful in threaded programming when information must be
exchanged safely between multiple threads. The :class:`Queue` class in this exchanged safely between multiple threads. The :class:`Queue` class in this
module implements all the required locking semantics. It depends on the module implements all the required locking semantics. It depends on the
availability of thread support in Python. availability of thread support in Python; see the :mod:`threading`
module.
The :mod:`Queue` module defines the following class and exception: The :mod:`Queue` module defines the following class and exception:

View File

@ -13,9 +13,11 @@
single: semaphores, binary single: semaphores, binary
This module provides low-level primitives for working with multiple threads This module provides low-level primitives for working with multiple threads
(a.k.a. :dfn:`light-weight processes` or :dfn:`tasks`) --- multiple threads of (also called :dfn:`light-weight processes` or :dfn:`tasks`) --- multiple threads of
control sharing their global data space. For synchronization, simple locks control sharing their global data space. For synchronization, simple locks
(a.k.a. :dfn:`mutexes` or :dfn:`binary semaphores`) are provided. (also called :dfn:`mutexes` or :dfn:`binary semaphores`) are provided.
The :mod:`threading` module provides an easier to use and higher-level
threading API built on top of this module.
.. index:: .. index::
single: pthreads single: pthreads

View File

@ -8,6 +8,7 @@
This module constructs higher-level threading interfaces on top of the lower This module constructs higher-level threading interfaces on top of the lower
level :mod:`thread` module. level :mod:`thread` module.
See also the :mod:`mutex` and :mod:`Queue` modules.
The :mod:`dummy_threading` module is provided for situations where The :mod:`dummy_threading` module is provided for situations where
:mod:`threading` cannot be used because :mod:`thread` is missing. :mod:`threading` cannot be used because :mod:`thread` is missing.