mirror of https://github.com/python/cpython
Added cross-references plus a note about dict & list shallow copying.
This commit is contained in:
parent
691632f14d
commit
fcb444a8bf
|
@ -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.
|
||||||
|
|
||||||
|
|
|
@ -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:
|
||||||
|
|
||||||
|
|
|
@ -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:
|
||||||
|
|
||||||
|
|
|
@ -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
|
||||||
|
|
|
@ -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.
|
||||||
|
|
Loading…
Reference in New Issue