2007-08-17 03:27:11 -03:00
|
|
|
.. _glossary:
|
|
|
|
|
|
|
|
********
|
|
|
|
Glossary
|
|
|
|
********
|
|
|
|
|
|
|
|
.. if you add new entries, keep the alphabetical sorting!
|
|
|
|
|
|
|
|
.. glossary::
|
|
|
|
|
|
|
|
``>>>``
|
2008-09-14 23:03:05 -03:00
|
|
|
The default Python prompt of the interactive shell. Often seen for code
|
|
|
|
examples which can be executed interactively in the interpreter.
|
2009-01-03 16:55:06 -04:00
|
|
|
|
2007-08-17 03:27:11 -03:00
|
|
|
``...``
|
2008-09-14 23:03:05 -03:00
|
|
|
The default Python prompt of the interactive shell when entering code for
|
|
|
|
an indented code block or within a pair of matching left and right
|
|
|
|
delimiters (parentheses, square brackets or curly braces).
|
2007-12-02 10:58:50 -04:00
|
|
|
|
2008-05-20 04:20:12 -03:00
|
|
|
2to3
|
|
|
|
A tool that tries to convert Python 2.x code to Python 3.x code by
|
2010-10-06 06:32:48 -03:00
|
|
|
handling most of the incompatibilities which can be detected by parsing the
|
2008-05-20 04:20:12 -03:00
|
|
|
source and traversing the parse tree.
|
|
|
|
|
|
|
|
2to3 is available in the standard library as :mod:`lib2to3`; a standalone
|
2008-07-23 23:45:37 -03:00
|
|
|
entry point is provided as :file:`Tools/scripts/2to3`. See
|
|
|
|
:ref:`2to3-reference`.
|
2008-05-20 04:20:12 -03:00
|
|
|
|
2008-07-03 09:57:35 -03:00
|
|
|
abstract base class
|
2011-07-29 06:34:17 -03:00
|
|
|
Abstract base classes complement :term:`duck-typing` by
|
2009-07-26 11:37:28 -03:00
|
|
|
providing a way to define interfaces when other techniques like
|
2011-07-29 06:34:17 -03:00
|
|
|
:func:`hasattr` would be clumsy or subtly wrong (for example with
|
2011-08-19 04:15:47 -03:00
|
|
|
:ref:`magic methods <new-style-special-lookup>`). ABCs introduce virtual
|
|
|
|
subclasses, which are classes that don't inherit from a class but are
|
|
|
|
still recognized by :func:`isinstance` and :func:`issubclass`; see the
|
|
|
|
:mod:`abc` module documentation. Python comes with many built-in ABCs for
|
2009-07-26 11:37:28 -03:00
|
|
|
data structures (in the :mod:`collections` module), numbers (in the
|
|
|
|
:mod:`numbers` module), and streams (in the :mod:`io` module). You can
|
2011-07-29 06:34:17 -03:00
|
|
|
create your own ABCs with the :mod:`abc` module.
|
2008-07-01 20:33:06 -03:00
|
|
|
|
2007-12-02 10:58:50 -04:00
|
|
|
argument
|
2008-09-14 23:03:05 -03:00
|
|
|
A value passed to a function or method, assigned to a named local
|
|
|
|
variable in the function body. A function or method may have both
|
|
|
|
positional arguments and keyword arguments in its definition.
|
|
|
|
Positional and keyword arguments may be variable-length: ``*`` accepts
|
|
|
|
or passes (if in the function definition or call) several positional
|
|
|
|
arguments in a list, while ``**`` does the same for keyword arguments
|
|
|
|
in a dictionary.
|
2007-12-02 10:58:50 -04:00
|
|
|
|
|
|
|
Any expression may be used within the argument list, and the evaluated
|
|
|
|
value is passed to the local variable.
|
2008-09-14 23:19:53 -03:00
|
|
|
|
|
|
|
attribute
|
|
|
|
A value associated with an object which is referenced by name using
|
|
|
|
dotted expressions. For example, if an object *o* has an attribute
|
|
|
|
*a* it would be referenced as *o.a*.
|
2009-01-03 16:55:06 -04:00
|
|
|
|
2007-08-17 03:27:11 -03:00
|
|
|
BDFL
|
|
|
|
Benevolent Dictator For Life, a.k.a. `Guido van Rossum
|
|
|
|
<http://www.python.org/~guido/>`_, Python's creator.
|
2009-01-03 16:55:06 -04:00
|
|
|
|
2007-10-21 07:24:20 -03:00
|
|
|
bytecode
|
|
|
|
Python source code is compiled into bytecode, the internal representation
|
2011-08-18 20:27:00 -03:00
|
|
|
of a Python program in the CPython interpreter. The bytecode is also
|
|
|
|
cached in ``.pyc`` and ``.pyo`` files so that executing the same file is
|
|
|
|
faster the second time (recompilation from source to bytecode can be
|
|
|
|
avoided). This "intermediate language" is said to run on a
|
|
|
|
:term:`virtual machine` that executes the machine code corresponding to
|
|
|
|
each bytecode. Do note that bytecodes are not expected to work between
|
|
|
|
different Python virtual machines, nor to be stable between Python
|
|
|
|
releases.
|
2008-09-14 23:19:53 -03:00
|
|
|
|
2010-07-03 07:25:54 -03:00
|
|
|
A list of bytecode instructions can be found in the documentation for
|
|
|
|
:ref:`the dis module <bytecodes>`.
|
|
|
|
|
2008-09-14 23:19:53 -03:00
|
|
|
class
|
|
|
|
A template for creating user-defined objects. Class definitions
|
|
|
|
normally contain method definitions which operate on instances of the
|
|
|
|
class.
|
2009-01-03 16:55:06 -04:00
|
|
|
|
2007-08-17 03:27:11 -03:00
|
|
|
classic class
|
|
|
|
Any class which does not inherit from :class:`object`. See
|
2012-05-03 13:21:40 -03:00
|
|
|
:term:`new-style class`. Classic classes have been removed in Python 3.
|
2009-01-03 16:55:06 -04:00
|
|
|
|
2007-08-17 03:27:11 -03:00
|
|
|
coercion
|
|
|
|
The implicit conversion of an instance of one type to another during an
|
|
|
|
operation which involves two arguments of the same type. For example,
|
|
|
|
``int(3.15)`` converts the floating point number to the integer ``3``, but
|
|
|
|
in ``3+4.5``, each argument is of a different type (one int, one float),
|
|
|
|
and both must be converted to the same type before they can be added or it
|
|
|
|
will raise a ``TypeError``. Coercion between two operands can be
|
2009-07-26 11:37:28 -03:00
|
|
|
performed with the ``coerce`` built-in function; thus, ``3+4.5`` is
|
2007-08-17 03:27:11 -03:00
|
|
|
equivalent to calling ``operator.add(*coerce(3, 4.5))`` and results in
|
|
|
|
``operator.add(3.0, 4.5)``. Without coercion, all arguments of even
|
|
|
|
compatible types would have to be normalized to the same value by the
|
|
|
|
programmer, e.g., ``float(3)+4.5`` rather than just ``3+4.5``.
|
2009-01-03 16:55:06 -04:00
|
|
|
|
2007-08-17 03:27:11 -03:00
|
|
|
complex number
|
|
|
|
An extension of the familiar real number system in which all numbers are
|
|
|
|
expressed as a sum of a real part and an imaginary part. Imaginary
|
|
|
|
numbers are real multiples of the imaginary unit (the square root of
|
|
|
|
``-1``), often written ``i`` in mathematics or ``j`` in
|
2009-07-26 11:37:28 -03:00
|
|
|
engineering. Python has built-in support for complex numbers, which are
|
2007-08-17 03:27:11 -03:00
|
|
|
written with this latter notation; the imaginary part is written with a
|
|
|
|
``j`` suffix, e.g., ``3+1j``. To get access to complex equivalents of the
|
|
|
|
:mod:`math` module, use :mod:`cmath`. Use of complex numbers is a fairly
|
|
|
|
advanced mathematical feature. If you're not aware of a need for them,
|
|
|
|
it's almost certain you can safely ignore them.
|
2009-01-03 16:55:06 -04:00
|
|
|
|
2007-12-08 11:23:31 -04:00
|
|
|
context manager
|
2008-09-14 23:03:05 -03:00
|
|
|
An object which controls the environment seen in a :keyword:`with`
|
2007-12-08 11:23:31 -04:00
|
|
|
statement by defining :meth:`__enter__` and :meth:`__exit__` methods.
|
|
|
|
See :pep:`343`.
|
|
|
|
|
2008-09-14 23:03:05 -03:00
|
|
|
CPython
|
2011-01-06 12:35:14 -04:00
|
|
|
The canonical implementation of the Python programming language, as
|
|
|
|
distributed on `python.org <http://python.org>`_. The term "CPython"
|
|
|
|
is used when necessary to distinguish this implementation from others
|
|
|
|
such as Jython or IronPython.
|
2008-09-14 23:03:05 -03:00
|
|
|
|
2007-12-02 10:58:50 -04:00
|
|
|
decorator
|
|
|
|
A function returning another function, usually applied as a function
|
|
|
|
transformation using the ``@wrapper`` syntax. Common examples for
|
|
|
|
decorators are :func:`classmethod` and :func:`staticmethod`.
|
|
|
|
|
|
|
|
The decorator syntax is merely syntactic sugar, the following two
|
|
|
|
function definitions are semantically equivalent::
|
|
|
|
|
|
|
|
def f(...):
|
|
|
|
...
|
|
|
|
f = staticmethod(f)
|
|
|
|
|
|
|
|
@staticmethod
|
|
|
|
def f(...):
|
|
|
|
...
|
|
|
|
|
2011-08-18 20:27:00 -03:00
|
|
|
The same concept exists for classes, but is less commonly used there. See
|
|
|
|
the documentation for :ref:`function definitions <function>` and
|
|
|
|
:ref:`class definitions <class>` for more about decorators.
|
2008-12-05 14:00:06 -04:00
|
|
|
|
2007-08-17 03:27:11 -03:00
|
|
|
descriptor
|
2008-09-14 23:03:05 -03:00
|
|
|
Any *new-style* object which defines the methods :meth:`__get__`,
|
2007-10-21 07:45:46 -03:00
|
|
|
:meth:`__set__`, or :meth:`__delete__`. When a class attribute is a
|
2007-08-17 03:27:11 -03:00
|
|
|
descriptor, its special binding behavior is triggered upon attribute
|
2007-10-21 07:45:46 -03:00
|
|
|
lookup. Normally, using *a.b* to get, set or delete an attribute looks up
|
|
|
|
the object named *b* in the class dictionary for *a*, but if *b* is a
|
|
|
|
descriptor, the respective descriptor method gets called. Understanding
|
|
|
|
descriptors is a key to a deep understanding of Python because they are
|
|
|
|
the basis for many features including functions, methods, properties,
|
|
|
|
class methods, static methods, and reference to super classes.
|
|
|
|
|
|
|
|
For more information about descriptors' methods, see :ref:`descriptors`.
|
2009-01-03 16:55:06 -04:00
|
|
|
|
2007-08-17 03:27:11 -03:00
|
|
|
dictionary
|
2012-03-12 14:05:04 -03:00
|
|
|
An associative array, where arbitrary keys are mapped to values. The
|
|
|
|
keys can be any object with :meth:`__hash__` and :meth:`__eq__` methods.
|
|
|
|
Called a hash in Perl.
|
2008-07-20 08:50:29 -03:00
|
|
|
|
|
|
|
docstring
|
2008-09-14 23:03:05 -03:00
|
|
|
A string literal which appears as the first expression in a class,
|
|
|
|
function or module. While ignored when the suite is executed, it is
|
|
|
|
recognized by the compiler and put into the :attr:`__doc__` attribute
|
|
|
|
of the enclosing class, function or module. Since it is available via
|
|
|
|
introspection, it is the canonical place for documentation of the
|
2008-07-20 08:50:29 -03:00
|
|
|
object.
|
2009-01-03 16:55:06 -04:00
|
|
|
|
|
|
|
duck-typing
|
2010-10-06 06:17:24 -03:00
|
|
|
A programming style which does not look at an object's type to determine
|
|
|
|
if it has the right interface; instead, the method or attribute is simply
|
|
|
|
called or used ("If it looks like a duck and quacks like a duck, it
|
2007-08-17 03:27:11 -03:00
|
|
|
must be a duck.") By emphasizing interfaces rather than specific types,
|
|
|
|
well-designed code improves its flexibility by allowing polymorphic
|
|
|
|
substitution. Duck-typing avoids tests using :func:`type` or
|
2010-07-11 05:56:18 -03:00
|
|
|
:func:`isinstance`. (Note, however, that duck-typing can be complemented
|
2011-08-18 20:27:00 -03:00
|
|
|
with :term:`abstract base classes <abstract base class>`.) Instead, it
|
|
|
|
typically employs :func:`hasattr` tests or :term:`EAFP` programming.
|
2009-01-03 16:55:06 -04:00
|
|
|
|
2007-08-17 03:27:11 -03:00
|
|
|
EAFP
|
|
|
|
Easier to ask for forgiveness than permission. This common Python coding
|
|
|
|
style assumes the existence of valid keys or attributes and catches
|
|
|
|
exceptions if the assumption proves false. This clean and fast style is
|
|
|
|
characterized by the presence of many :keyword:`try` and :keyword:`except`
|
2009-01-03 16:55:06 -04:00
|
|
|
statements. The technique contrasts with the :term:`LBYL` style
|
2008-09-14 23:03:05 -03:00
|
|
|
common to many other languages such as C.
|
2007-08-17 03:27:11 -03:00
|
|
|
|
2007-12-02 10:58:50 -04:00
|
|
|
expression
|
|
|
|
A piece of syntax which can be evaluated to some value. In other words,
|
2011-08-18 20:27:00 -03:00
|
|
|
an expression is an accumulation of expression elements like literals,
|
|
|
|
names, attribute access, operators or function calls which all return a
|
|
|
|
value. In contrast to many other languages, not all language constructs
|
|
|
|
are expressions. There are also :term:`statement`\s which cannot be used
|
|
|
|
as expressions, such as :keyword:`print` or :keyword:`if`. Assignments
|
|
|
|
are also statements, not expressions.
|
2007-12-02 10:58:50 -04:00
|
|
|
|
2007-08-17 03:27:11 -03:00
|
|
|
extension module
|
Merged revisions 87050,87101,87146,87156,87172,87175,87371,87378,87522-87524,87526,87530-87535 via svnmerge from
svn+ssh://pythondev@svn.python.org/python/branches/py3k
........
r87050 | georg.brandl | 2010-12-04 18:09:30 +0100 (Sa, 04 Dez 2010) | 1 line
Fix typo.
........
r87101 | georg.brandl | 2010-12-06 23:02:48 +0100 (Mo, 06 Dez 2010) | 1 line
Remove visible XXX comments.
........
r87146 | georg.brandl | 2010-12-09 19:08:43 +0100 (Do, 09 Dez 2010) | 1 line
Fix "seperate".
........
r87156 | georg.brandl | 2010-12-10 11:01:44 +0100 (Fr, 10 Dez 2010) | 1 line
#10668: fix wrong call of __init__.
........
r87172 | georg.brandl | 2010-12-11 20:10:30 +0100 (Sa, 11 Dez 2010) | 1 line
Avoid AttributeError(_closed) when a TemporaryDirectory is deallocated whose mkdtemp call failed.
........
r87175 | georg.brandl | 2010-12-11 23:19:34 +0100 (Sa, 11 Dez 2010) | 1 line
Fix markup.
........
r87371 | georg.brandl | 2010-12-18 17:21:58 +0100 (Sa, 18 Dez 2010) | 1 line
Fix typo.
........
r87378 | georg.brandl | 2010-12-18 18:51:28 +0100 (Sa, 18 Dez 2010) | 1 line
#10723: add missing builtin exceptions.
........
r87522 | georg.brandl | 2010-12-28 10:16:12 +0100 (Di, 28 Dez 2010) | 1 line
Replace sys.maxint mention by sys.maxsize.
........
r87523 | georg.brandl | 2010-12-28 10:18:24 +0100 (Di, 28 Dez 2010) | 1 line
Remove confusing paragraph -- this is relevant only to advanced users anyway and does not belong into the tutorial.
........
r87524 | georg.brandl | 2010-12-28 10:29:19 +0100 (Di, 28 Dez 2010) | 1 line
Fix advice: call PyType_Ready to fill in ob_type of custom types.
........
r87526 | georg.brandl | 2010-12-28 11:38:33 +0100 (Di, 28 Dez 2010) | 1 line
#10777: fix iteration over dict keys while mutating the dict.
........
r87530 | georg.brandl | 2010-12-28 12:06:07 +0100 (Di, 28 Dez 2010) | 1 line
#10767: update README in crashers; not all may have a bug entry and/or be fixed.
........
r87531 | georg.brandl | 2010-12-28 12:08:17 +0100 (Di, 28 Dez 2010) | 1 line
#10742: document readonly attribute of memoryviews.
........
r87532 | georg.brandl | 2010-12-28 12:15:49 +0100 (Di, 28 Dez 2010) | 1 line
#10781: clarify that *encoding* is not a parameter for Node objects in general.
........
r87533 | georg.brandl | 2010-12-28 12:38:12 +0100 (Di, 28 Dez 2010) | 1 line
Remove history; adapt a bit more to reST, since this will once be part of the dev guide.
........
r87534 | georg.brandl | 2010-12-28 12:48:53 +0100 (Di, 28 Dez 2010) | 1 line
Rewrap.
........
r87535 | georg.brandl | 2010-12-28 12:49:41 +0100 (Di, 28 Dez 2010) | 1 line
#10739: document that on Windows, socket.makefile() does not make a file that has a true file descriptor usable where such a thing is expected.
........
2011-02-25 06:50:32 -04:00
|
|
|
A module written in C or C++, using Python's C API to interact with the
|
|
|
|
core and with user code.
|
2007-12-02 10:58:50 -04:00
|
|
|
|
2011-08-18 20:27:00 -03:00
|
|
|
file object
|
|
|
|
An object exposing a file-oriented API (with methods such as
|
|
|
|
:meth:`read()` or :meth:`write()`) to an underlying resource. Depending
|
|
|
|
on the way it was created, a file object can mediate access to a real
|
|
|
|
on-disk file or to another other type of storage or communication device
|
|
|
|
(for example standard input/output, in-memory buffers, sockets, pipes,
|
|
|
|
etc.). File objects are also called :dfn:`file-like objects` or
|
|
|
|
:dfn:`streams`.
|
|
|
|
|
|
|
|
There are actually three categories of file objects: raw binary files,
|
|
|
|
buffered binary files and text files. Their interfaces are defined in the
|
|
|
|
:mod:`io` module. The canonical way to create a file object is by using
|
|
|
|
the :func:`open` function.
|
|
|
|
|
|
|
|
file-like object
|
|
|
|
A synonym for :term:`file object`.
|
|
|
|
|
2009-03-31 13:11:45 -03:00
|
|
|
finder
|
|
|
|
An object that tries to find the :term:`loader` for a module. It must
|
|
|
|
implement a method named :meth:`find_module`. See :pep:`302` for
|
|
|
|
details.
|
|
|
|
|
2010-09-01 19:25:41 -03:00
|
|
|
floor division
|
|
|
|
Mathematical division that rounds down to nearest integer. The floor
|
|
|
|
division operator is ``//``. For example, the expression ``11 // 4``
|
|
|
|
evaluates to ``2`` in contrast to the ``2.75`` returned by float true
|
|
|
|
division. Note that ``(-11) // 4`` is ``-3`` because that is ``-2.75``
|
|
|
|
rounded *downward*. See :pep:`238`.
|
|
|
|
|
2007-12-02 10:58:50 -04:00
|
|
|
function
|
|
|
|
A series of statements which returns some value to a caller. It can also
|
|
|
|
be passed zero or more arguments which may be used in the execution of
|
|
|
|
the body. See also :term:`argument` and :term:`method`.
|
|
|
|
|
2007-08-17 03:27:11 -03:00
|
|
|
__future__
|
2010-09-01 19:25:41 -03:00
|
|
|
A pseudo-module which programmers can use to enable new language features
|
2007-08-17 03:27:11 -03:00
|
|
|
which are not compatible with the current interpreter. For example, the
|
|
|
|
expression ``11/4`` currently evaluates to ``2``. If the module in which
|
|
|
|
it is executed had enabled *true division* by executing::
|
2009-01-03 16:55:06 -04:00
|
|
|
|
2007-08-17 03:27:11 -03:00
|
|
|
from __future__ import division
|
2009-01-03 16:55:06 -04:00
|
|
|
|
2007-08-17 03:27:11 -03:00
|
|
|
the expression ``11/4`` would evaluate to ``2.75``. By importing the
|
|
|
|
:mod:`__future__` module and evaluating its variables, you can see when a
|
|
|
|
new feature was first added to the language and when it will become the
|
|
|
|
default::
|
2009-01-03 16:55:06 -04:00
|
|
|
|
2007-08-17 03:27:11 -03:00
|
|
|
>>> import __future__
|
|
|
|
>>> __future__.division
|
|
|
|
_Feature((2, 2, 0, 'alpha', 2), (3, 0, 0, 'alpha', 0), 8192)
|
|
|
|
|
|
|
|
garbage collection
|
|
|
|
The process of freeing memory when it is not used anymore. Python
|
|
|
|
performs garbage collection via reference counting and a cyclic garbage
|
|
|
|
collector that is able to detect and break reference cycles.
|
2009-01-03 16:55:06 -04:00
|
|
|
|
2010-04-02 06:11:49 -03:00
|
|
|
.. index:: single: generator
|
|
|
|
|
2007-08-17 03:27:11 -03:00
|
|
|
generator
|
2008-09-14 23:03:05 -03:00
|
|
|
A function which returns an iterator. It looks like a normal function
|
2010-09-01 19:25:41 -03:00
|
|
|
except that it contains :keyword:`yield` statements for producing a series
|
|
|
|
a values usable in a for-loop or that can be retrieved one at a time with
|
|
|
|
the :func:`next` function. Each :keyword:`yield` temporarily suspends
|
|
|
|
processing, remembering the location execution state (including local
|
|
|
|
variables and pending try-statements). When the generator resumes, it
|
|
|
|
picks-up where it left-off (in contrast to functions which start fresh on
|
|
|
|
every invocation).
|
2009-01-03 16:55:06 -04:00
|
|
|
|
2007-08-17 03:27:11 -03:00
|
|
|
.. index:: single: generator expression
|
2009-01-03 16:55:06 -04:00
|
|
|
|
2007-08-17 03:27:11 -03:00
|
|
|
generator expression
|
2010-04-02 06:11:49 -03:00
|
|
|
An expression that returns an iterator. It looks like a normal expression
|
2007-08-17 03:27:11 -03:00
|
|
|
followed by a :keyword:`for` expression defining a loop variable, range,
|
|
|
|
and an optional :keyword:`if` expression. The combined expression
|
|
|
|
generates values for an enclosing function::
|
2009-01-03 16:55:06 -04:00
|
|
|
|
2007-08-17 03:27:11 -03:00
|
|
|
>>> sum(i*i for i in range(10)) # sum of squares 0, 1, 4, ... 81
|
|
|
|
285
|
2009-01-03 16:55:06 -04:00
|
|
|
|
2007-08-17 03:27:11 -03:00
|
|
|
GIL
|
2007-08-17 13:54:59 -03:00
|
|
|
See :term:`global interpreter lock`.
|
2009-01-03 16:55:06 -04:00
|
|
|
|
2007-08-17 03:27:11 -03:00
|
|
|
global interpreter lock
|
2011-01-06 12:35:14 -04:00
|
|
|
The mechanism used by the :term:`CPython` interpreter to assure that
|
|
|
|
only one thread executes Python :term:`bytecode` at a time.
|
|
|
|
This simplifies the CPython implementation by making the object model
|
|
|
|
(including critical built-in types such as :class:`dict`) implicitly
|
|
|
|
safe against concurrent access. Locking the entire interpreter
|
|
|
|
makes it easier for the interpreter to be multi-threaded, at the
|
|
|
|
expense of much of the parallelism afforded by multi-processor
|
|
|
|
machines.
|
|
|
|
|
|
|
|
However, some extension modules, either standard or third-party,
|
|
|
|
are designed so as to release the GIL when doing computationally-intensive
|
|
|
|
tasks such as compression or hashing. Also, the GIL is always released
|
|
|
|
when doing I/O.
|
|
|
|
|
|
|
|
Past efforts to create a "free-threaded" interpreter (one which locks
|
|
|
|
shared data at a much finer granularity) have not been successful
|
|
|
|
because performance suffered in the common single-processor case. It
|
|
|
|
is believed that overcoming this performance issue would make the
|
|
|
|
implementation much more complicated and therefore costlier to maintain.
|
2007-11-02 17:06:17 -03:00
|
|
|
|
|
|
|
hashable
|
2008-09-14 23:03:05 -03:00
|
|
|
An object is *hashable* if it has a hash value which never changes during
|
2007-11-02 17:06:17 -03:00
|
|
|
its lifetime (it needs a :meth:`__hash__` method), and can be compared to
|
|
|
|
other objects (it needs an :meth:`__eq__` or :meth:`__cmp__` method).
|
2008-09-14 23:03:05 -03:00
|
|
|
Hashable objects which compare equal must have the same hash value.
|
2007-11-02 17:06:17 -03:00
|
|
|
|
|
|
|
Hashability makes an object usable as a dictionary key and a set member,
|
|
|
|
because these data structures use the hash value internally.
|
|
|
|
|
2008-09-14 23:03:05 -03:00
|
|
|
All of Python's immutable built-in objects are hashable, while no mutable
|
|
|
|
containers (such as lists or dictionaries) are. Objects which are
|
2007-11-02 17:06:17 -03:00
|
|
|
instances of user-defined classes are hashable by default; they all
|
|
|
|
compare unequal, and their hash value is their :func:`id`.
|
2009-01-03 16:55:06 -04:00
|
|
|
|
2007-08-17 03:27:11 -03:00
|
|
|
IDLE
|
|
|
|
An Integrated Development Environment for Python. IDLE is a basic editor
|
2008-09-14 23:03:05 -03:00
|
|
|
and interpreter environment which ships with the standard distribution of
|
2010-09-01 19:25:41 -03:00
|
|
|
Python.
|
2009-01-03 16:55:06 -04:00
|
|
|
|
2007-08-17 03:27:11 -03:00
|
|
|
immutable
|
2008-09-14 23:03:05 -03:00
|
|
|
An object with a fixed value. Immutable objects include numbers, strings and
|
|
|
|
tuples. Such an object cannot be altered. A new object has to
|
2007-08-17 03:27:11 -03:00
|
|
|
be created if a different value has to be stored. They play an important
|
|
|
|
role in places where a constant hash value is needed, for example as a key
|
|
|
|
in a dictionary.
|
2009-01-03 16:55:06 -04:00
|
|
|
|
2007-08-17 03:27:11 -03:00
|
|
|
integer division
|
|
|
|
Mathematical division discarding any remainder. For example, the
|
|
|
|
expression ``11/4`` currently evaluates to ``2`` in contrast to the
|
|
|
|
``2.75`` returned by float division. Also called *floor division*.
|
|
|
|
When dividing two integers the outcome will always be another integer
|
|
|
|
(having the floor function applied to it). However, if one of the operands
|
|
|
|
is another numeric type (such as a :class:`float`), the result will be
|
2007-08-17 13:54:59 -03:00
|
|
|
coerced (see :term:`coercion`) to a common type. For example, an integer
|
2007-08-17 03:27:11 -03:00
|
|
|
divided by a float will result in a float value, possibly with a decimal
|
|
|
|
fraction. Integer division can be forced by using the ``//`` operator
|
2007-08-17 13:54:59 -03:00
|
|
|
instead of the ``/`` operator. See also :term:`__future__`.
|
2009-01-03 16:55:06 -04:00
|
|
|
|
2009-03-31 13:11:45 -03:00
|
|
|
importer
|
|
|
|
An object that both finds and loads a module; both a
|
|
|
|
:term:`finder` and :term:`loader` object.
|
|
|
|
|
2007-08-17 03:27:11 -03:00
|
|
|
interactive
|
2008-09-14 23:03:05 -03:00
|
|
|
Python has an interactive interpreter which means you can enter
|
|
|
|
statements and expressions at the interpreter prompt, immediately
|
|
|
|
execute them and see their results. Just launch ``python`` with no
|
|
|
|
arguments (possibly by selecting it from your computer's main
|
|
|
|
menu). It is a very powerful way to test out new ideas or inspect
|
|
|
|
modules and packages (remember ``help(x)``).
|
2009-01-03 16:55:06 -04:00
|
|
|
|
2007-08-17 03:27:11 -03:00
|
|
|
interpreted
|
2008-09-14 23:03:05 -03:00
|
|
|
Python is an interpreted language, as opposed to a compiled one,
|
|
|
|
though the distinction can be blurry because of the presence of the
|
|
|
|
bytecode compiler. This means that source files can be run directly
|
|
|
|
without explicitly creating an executable which is then run.
|
|
|
|
Interpreted languages typically have a shorter development/debug cycle
|
|
|
|
than compiled ones, though their programs generally also run more
|
|
|
|
slowly. See also :term:`interactive`.
|
2009-01-03 16:55:06 -04:00
|
|
|
|
2007-08-17 03:27:11 -03:00
|
|
|
iterable
|
2011-08-18 20:27:00 -03:00
|
|
|
An object capable of returning its members one at a
|
2007-08-17 03:27:11 -03:00
|
|
|
time. Examples of iterables include all sequence types (such as
|
|
|
|
:class:`list`, :class:`str`, and :class:`tuple`) and some non-sequence
|
|
|
|
types like :class:`dict` and :class:`file` and objects of any classes you
|
|
|
|
define with an :meth:`__iter__` or :meth:`__getitem__` method. Iterables
|
|
|
|
can be used in a :keyword:`for` loop and in many other places where a
|
|
|
|
sequence is needed (:func:`zip`, :func:`map`, ...). When an iterable
|
2009-07-26 11:37:28 -03:00
|
|
|
object is passed as an argument to the built-in function :func:`iter`, it
|
2007-08-17 03:27:11 -03:00
|
|
|
returns an iterator for the object. This iterator is good for one pass
|
|
|
|
over the set of values. When using iterables, it is usually not necessary
|
|
|
|
to call :func:`iter` or deal with iterator objects yourself. The ``for``
|
|
|
|
statement does that automatically for you, creating a temporary unnamed
|
|
|
|
variable to hold the iterator for the duration of the loop. See also
|
2007-08-17 13:54:59 -03:00
|
|
|
:term:`iterator`, :term:`sequence`, and :term:`generator`.
|
2009-01-03 16:55:06 -04:00
|
|
|
|
2007-08-17 03:27:11 -03:00
|
|
|
iterator
|
|
|
|
An object representing a stream of data. Repeated calls to the iterator's
|
|
|
|
:meth:`next` method return successive items in the stream. When no more
|
2008-09-14 23:03:05 -03:00
|
|
|
data are available a :exc:`StopIteration` exception is raised instead. At
|
2007-08-17 03:27:11 -03:00
|
|
|
this point, the iterator object is exhausted and any further calls to its
|
|
|
|
:meth:`next` method just raise :exc:`StopIteration` again. Iterators are
|
|
|
|
required to have an :meth:`__iter__` method that returns the iterator
|
|
|
|
object itself so every iterator is also iterable and may be used in most
|
|
|
|
places where other iterables are accepted. One notable exception is code
|
2008-09-14 23:03:05 -03:00
|
|
|
which attempts multiple iteration passes. A container object (such as a
|
2007-08-17 03:27:11 -03:00
|
|
|
:class:`list`) produces a fresh new iterator each time you pass it to the
|
|
|
|
:func:`iter` function or use it in a :keyword:`for` loop. Attempting this
|
|
|
|
with an iterator will just return the same exhausted iterator object used
|
|
|
|
in the previous iteration pass, making it appear like an empty container.
|
2009-01-03 16:55:06 -04:00
|
|
|
|
2007-10-21 09:10:28 -03:00
|
|
|
More information can be found in :ref:`typeiter`.
|
|
|
|
|
Merged revisions 85843,85849-85850,85867,85907,85914,86134,86187,86315-86316,86390,86424-86425,86428 via svnmerge from
svn+ssh://pythondev@svn.python.org/python/branches/py3k
........
r85843 | georg.brandl | 2010-10-26 08:59:23 +0200 (Di, 26 Okt 2010) | 1 line
Markup fix.
........
r85849 | georg.brandl | 2010-10-26 21:31:06 +0200 (Di, 26 Okt 2010) | 1 line
#10200: typo.
........
r85850 | georg.brandl | 2010-10-26 21:58:11 +0200 (Di, 26 Okt 2010) | 1 line
#10200: typo.
........
r85867 | georg.brandl | 2010-10-27 22:01:51 +0200 (Mi, 27 Okt 2010) | 1 line
Add David.
........
r85907 | georg.brandl | 2010-10-29 06:54:13 +0200 (Fr, 29 Okt 2010) | 1 line
#10222: fix for overzealous AIX compiler.
........
r85914 | georg.brandl | 2010-10-29 08:17:38 +0200 (Fr, 29 Okt 2010) | 1 line
(?:...) is a non-capturing, but still grouping construct.
........
r86134 | georg.brandl | 2010-11-03 08:41:00 +0100 (Mi, 03 Nov 2010) | 1 line
A newline in lineno output breaks pyframe output.
........
r86187 | georg.brandl | 2010-11-05 08:10:41 +0100 (Fr, 05 Nov 2010) | 1 line
Move glossary entry to the right position and fix link.
........
r86315 | georg.brandl | 2010-11-08 12:05:18 +0100 (Mo, 08 Nov 2010) | 1 line
Fix latex conversion glitch in property/feature descriptions.
........
r86316 | georg.brandl | 2010-11-08 12:08:35 +0100 (Mo, 08 Nov 2010) | 1 line
Fix typo.
........
r86390 | georg.brandl | 2010-11-10 08:57:10 +0100 (Mi, 10 Nov 2010) | 1 line
Fix typo.
........
r86424 | georg.brandl | 2010-11-12 07:19:48 +0100 (Fr, 12 Nov 2010) | 1 line
Build a PDF of the FAQs too.
........
r86425 | georg.brandl | 2010-11-12 07:20:12 +0100 (Fr, 12 Nov 2010) | 1 line
#10008: Fix duplicate index entry.
........
r86428 | georg.brandl | 2010-11-12 09:09:26 +0100 (Fr, 12 Nov 2010) | 1 line
Fix weird line block in table.
........
2010-11-26 04:20:18 -04:00
|
|
|
key function
|
|
|
|
A key function or collation function is a callable that returns a value
|
|
|
|
used for sorting or ordering. For example, :func:`locale.strxfrm` is
|
|
|
|
used to produce a sort key that is aware of locale specific sort
|
|
|
|
conventions.
|
|
|
|
|
|
|
|
A number of tools in Python accept key functions to control how elements
|
|
|
|
are ordered or grouped. They include :func:`min`, :func:`max`,
|
|
|
|
:func:`sorted`, :meth:`list.sort`, :func:`heapq.nsmallest`,
|
|
|
|
:func:`heapq.nlargest`, and :func:`itertools.groupby`.
|
|
|
|
|
|
|
|
There are several ways to create a key function. For example. the
|
|
|
|
:meth:`str.lower` method can serve as a key function for case insensitive
|
|
|
|
sorts. Alternatively, an ad-hoc key function can be built from a
|
|
|
|
:keyword:`lambda` expression such as ``lambda r: (r[0], r[2])``. Also,
|
2012-03-31 20:49:46 -03:00
|
|
|
the :mod:`operator` module provides three key function constructors:
|
Merged revisions 85843,85849-85850,85867,85907,85914,86134,86187,86315-86316,86390,86424-86425,86428 via svnmerge from
svn+ssh://pythondev@svn.python.org/python/branches/py3k
........
r85843 | georg.brandl | 2010-10-26 08:59:23 +0200 (Di, 26 Okt 2010) | 1 line
Markup fix.
........
r85849 | georg.brandl | 2010-10-26 21:31:06 +0200 (Di, 26 Okt 2010) | 1 line
#10200: typo.
........
r85850 | georg.brandl | 2010-10-26 21:58:11 +0200 (Di, 26 Okt 2010) | 1 line
#10200: typo.
........
r85867 | georg.brandl | 2010-10-27 22:01:51 +0200 (Mi, 27 Okt 2010) | 1 line
Add David.
........
r85907 | georg.brandl | 2010-10-29 06:54:13 +0200 (Fr, 29 Okt 2010) | 1 line
#10222: fix for overzealous AIX compiler.
........
r85914 | georg.brandl | 2010-10-29 08:17:38 +0200 (Fr, 29 Okt 2010) | 1 line
(?:...) is a non-capturing, but still grouping construct.
........
r86134 | georg.brandl | 2010-11-03 08:41:00 +0100 (Mi, 03 Nov 2010) | 1 line
A newline in lineno output breaks pyframe output.
........
r86187 | georg.brandl | 2010-11-05 08:10:41 +0100 (Fr, 05 Nov 2010) | 1 line
Move glossary entry to the right position and fix link.
........
r86315 | georg.brandl | 2010-11-08 12:05:18 +0100 (Mo, 08 Nov 2010) | 1 line
Fix latex conversion glitch in property/feature descriptions.
........
r86316 | georg.brandl | 2010-11-08 12:08:35 +0100 (Mo, 08 Nov 2010) | 1 line
Fix typo.
........
r86390 | georg.brandl | 2010-11-10 08:57:10 +0100 (Mi, 10 Nov 2010) | 1 line
Fix typo.
........
r86424 | georg.brandl | 2010-11-12 07:19:48 +0100 (Fr, 12 Nov 2010) | 1 line
Build a PDF of the FAQs too.
........
r86425 | georg.brandl | 2010-11-12 07:20:12 +0100 (Fr, 12 Nov 2010) | 1 line
#10008: Fix duplicate index entry.
........
r86428 | georg.brandl | 2010-11-12 09:09:26 +0100 (Fr, 12 Nov 2010) | 1 line
Fix weird line block in table.
........
2010-11-26 04:20:18 -04:00
|
|
|
:func:`~operator.attrgetter`, :func:`~operator.itemgetter`, and
|
|
|
|
:func:`~operator.methodcaller`. See the :ref:`Sorting HOW TO
|
|
|
|
<sortinghowto>` for examples of how to create and use key functions.
|
|
|
|
|
2007-12-02 10:58:50 -04:00
|
|
|
keyword argument
|
|
|
|
Arguments which are preceded with a ``variable_name=`` in the call.
|
|
|
|
The variable name designates the local name in the function to which the
|
|
|
|
value is assigned. ``**`` is used to accept or pass a dictionary of
|
|
|
|
keyword arguments. See :term:`argument`.
|
|
|
|
|
|
|
|
lambda
|
|
|
|
An anonymous inline function consisting of a single :term:`expression`
|
|
|
|
which is evaluated when the function is called. The syntax to create
|
|
|
|
a lambda function is ``lambda [arguments]: expression``
|
|
|
|
|
2007-08-17 03:27:11 -03:00
|
|
|
LBYL
|
|
|
|
Look before you leap. This coding style explicitly tests for
|
|
|
|
pre-conditions before making calls or lookups. This style contrasts with
|
2007-08-17 13:54:59 -03:00
|
|
|
the :term:`EAFP` approach and is characterized by the presence of many
|
2007-08-17 03:27:11 -03:00
|
|
|
:keyword:`if` statements.
|
2008-09-14 23:19:53 -03:00
|
|
|
|
2011-08-18 20:27:00 -03:00
|
|
|
In a multi-threaded environment, the LBYL approach can risk introducing a
|
|
|
|
race condition between "the looking" and "the leaping". For example, the
|
|
|
|
code, ``if key in mapping: return mapping[key]`` can fail if another
|
|
|
|
thread removes *key* from *mapping* after the test, but before the lookup.
|
|
|
|
This issue can be solved with locks or by using the EAFP approach.
|
|
|
|
|
2008-09-14 23:19:53 -03:00
|
|
|
list
|
|
|
|
A built-in Python :term:`sequence`. Despite its name it is more akin
|
|
|
|
to an array in other languages than to a linked list since access to
|
|
|
|
elements are O(1).
|
2009-01-03 16:55:06 -04:00
|
|
|
|
2007-08-17 03:27:11 -03:00
|
|
|
list comprehension
|
2008-09-14 23:03:05 -03:00
|
|
|
A compact way to process all or part of the elements in a sequence and
|
2007-08-17 03:27:11 -03:00
|
|
|
return a list with the results. ``result = ["0x%02x" % x for x in
|
2008-09-14 23:03:05 -03:00
|
|
|
range(256) if x % 2 == 0]`` generates a list of strings containing
|
|
|
|
even hex numbers (0x..) in the range from 0 to 255. The :keyword:`if`
|
|
|
|
clause is optional. If omitted, all elements in ``range(256)`` are
|
|
|
|
processed.
|
2009-01-03 16:55:06 -04:00
|
|
|
|
2009-03-31 13:11:45 -03:00
|
|
|
loader
|
|
|
|
An object that loads a module. It must define a method named
|
|
|
|
:meth:`load_module`. A loader is typically returned by a
|
|
|
|
:term:`finder`. See :pep:`302` for details.
|
|
|
|
|
2007-08-17 03:27:11 -03:00
|
|
|
mapping
|
2011-01-08 19:50:39 -04:00
|
|
|
A container object that supports arbitrary key lookups and implements the
|
2011-08-18 20:27:00 -03:00
|
|
|
methods specified in the :class:`~collections.Mapping` or
|
|
|
|
:class:`~collections.MutableMapping`
|
2011-07-29 06:34:17 -03:00
|
|
|
:ref:`abstract base classes <collections-abstract-base-classes>`. Examples
|
|
|
|
include :class:`dict`, :class:`collections.defaultdict`,
|
2011-01-08 19:50:39 -04:00
|
|
|
:class:`collections.OrderedDict` and :class:`collections.Counter`.
|
2009-01-03 16:55:06 -04:00
|
|
|
|
2007-08-17 03:27:11 -03:00
|
|
|
metaclass
|
|
|
|
The class of a class. Class definitions create a class name, a class
|
|
|
|
dictionary, and a list of base classes. The metaclass is responsible for
|
|
|
|
taking those three arguments and creating the class. Most object oriented
|
|
|
|
programming languages provide a default implementation. What makes Python
|
|
|
|
special is that it is possible to create custom metaclasses. Most users
|
|
|
|
never need this tool, but when the need arises, metaclasses can provide
|
|
|
|
powerful, elegant solutions. They have been used for logging attribute
|
|
|
|
access, adding thread-safety, tracking object creation, implementing
|
|
|
|
singletons, and many other tasks.
|
2007-10-21 09:15:05 -03:00
|
|
|
|
|
|
|
More information can be found in :ref:`metaclasses`.
|
2007-12-02 10:58:50 -04:00
|
|
|
|
|
|
|
method
|
2008-09-14 23:03:05 -03:00
|
|
|
A function which is defined inside a class body. If called as an attribute
|
2007-12-02 10:58:50 -04:00
|
|
|
of an instance of that class, the method will get the instance object as
|
|
|
|
its first :term:`argument` (which is usually called ``self``).
|
|
|
|
See :term:`function` and :term:`nested scope`.
|
2009-01-03 16:55:06 -04:00
|
|
|
|
2011-08-18 20:27:00 -03:00
|
|
|
method resolution order
|
|
|
|
Method Resolution Order is the order in which base classes are searched
|
|
|
|
for a member during lookup. See `The Python 2.3 Method Resolution Order
|
|
|
|
<http://www.python.org/download/releases/2.3/mro/>`_.
|
|
|
|
|
|
|
|
MRO
|
|
|
|
See :term:`method resolution order`.
|
|
|
|
|
2007-08-17 03:27:11 -03:00
|
|
|
mutable
|
|
|
|
Mutable objects can change their value but keep their :func:`id`. See
|
2007-08-17 13:54:59 -03:00
|
|
|
also :term:`immutable`.
|
2008-01-11 05:55:53 -04:00
|
|
|
|
|
|
|
named tuple
|
2009-02-04 15:25:17 -04:00
|
|
|
Any tuple-like class whose indexable elements are also accessible using
|
2008-01-13 02:15:15 -04:00
|
|
|
named attributes (for example, :func:`time.localtime` returns a
|
2008-01-13 02:18:07 -04:00
|
|
|
tuple-like object where the *year* is accessible either with an
|
2008-01-13 02:15:15 -04:00
|
|
|
index such as ``t[0]`` or with a named attribute like ``t.tm_year``).
|
|
|
|
|
|
|
|
A named tuple can be a built-in type such as :class:`time.struct_time`,
|
|
|
|
or it can be created with a regular class definition. A full featured
|
|
|
|
named tuple can also be created with the factory function
|
|
|
|
:func:`collections.namedtuple`. The latter approach automatically
|
|
|
|
provides extra features such as a self-documenting representation like
|
|
|
|
``Employee(name='jones', title='programmer')``.
|
2009-01-03 16:55:06 -04:00
|
|
|
|
2007-08-17 03:27:11 -03:00
|
|
|
namespace
|
|
|
|
The place where a variable is stored. Namespaces are implemented as
|
2009-07-26 11:37:28 -03:00
|
|
|
dictionaries. There are the local, global and built-in namespaces as well
|
2007-08-17 03:27:11 -03:00
|
|
|
as nested namespaces in objects (in methods). Namespaces support
|
|
|
|
modularity by preventing naming conflicts. For instance, the functions
|
|
|
|
:func:`__builtin__.open` and :func:`os.open` are distinguished by their
|
|
|
|
namespaces. Namespaces also aid readability and maintainability by making
|
|
|
|
it clear which module implements a function. For instance, writing
|
|
|
|
:func:`random.seed` or :func:`itertools.izip` makes it clear that those
|
|
|
|
functions are implemented by the :mod:`random` and :mod:`itertools`
|
2008-09-14 23:03:05 -03:00
|
|
|
modules, respectively.
|
2009-01-03 16:55:06 -04:00
|
|
|
|
2007-08-17 03:27:11 -03:00
|
|
|
nested scope
|
|
|
|
The ability to refer to a variable in an enclosing definition. For
|
|
|
|
instance, a function defined inside another function can refer to
|
2012-01-17 13:32:02 -04:00
|
|
|
variables in the outer function. Note that nested scopes work only for
|
|
|
|
reference and not for assignment which will always write to the innermost
|
|
|
|
scope. In contrast, local variables both read and write in the innermost
|
|
|
|
scope. Likewise, global variables read and write to the global namespace.
|
2009-01-03 16:55:06 -04:00
|
|
|
|
2007-08-17 03:27:11 -03:00
|
|
|
new-style class
|
2008-09-14 23:03:05 -03:00
|
|
|
Any class which inherits from :class:`object`. This includes all built-in
|
2007-08-17 03:27:11 -03:00
|
|
|
types like :class:`list` and :class:`dict`. Only new-style classes can
|
|
|
|
use Python's newer, versatile features like :attr:`__slots__`,
|
2008-09-14 23:03:05 -03:00
|
|
|
descriptors, properties, and :meth:`__getattribute__`.
|
2007-10-21 09:15:05 -03:00
|
|
|
|
|
|
|
More information can be found in :ref:`newstyle`.
|
2008-09-14 23:19:53 -03:00
|
|
|
|
|
|
|
object
|
|
|
|
Any data with state (attributes or value) and defined behavior
|
|
|
|
(methods). Also the ultimate base class of any :term:`new-style
|
|
|
|
class`.
|
2009-01-03 16:55:06 -04:00
|
|
|
|
2007-12-02 10:58:50 -04:00
|
|
|
positional argument
|
|
|
|
The arguments assigned to local names inside a function or method,
|
|
|
|
determined by the order in which they were given in the call. ``*`` is
|
|
|
|
used to either accept multiple positional arguments (when in the
|
|
|
|
definition), or pass several arguments as a list to a function. See
|
|
|
|
:term:`argument`.
|
|
|
|
|
2009-01-03 16:55:06 -04:00
|
|
|
Python 3000
|
2011-08-18 20:27:00 -03:00
|
|
|
Nickname for the Python 3.x release line (coined long ago when the release
|
|
|
|
of version 3 was something in the distant future.) This is also
|
|
|
|
abbreviated "Py3k".
|
2007-08-17 03:27:11 -03:00
|
|
|
|
2007-12-02 10:58:50 -04:00
|
|
|
Pythonic
|
2008-09-14 23:03:05 -03:00
|
|
|
An idea or piece of code which closely follows the most common idioms
|
|
|
|
of the Python language, rather than implementing code using concepts
|
|
|
|
common to other languages. For example, a common idiom in Python is
|
|
|
|
to loop over all elements of an iterable using a :keyword:`for`
|
|
|
|
statement. Many other languages don't have this type of construct, so
|
|
|
|
people unfamiliar with Python sometimes use a numerical counter instead::
|
2009-01-03 16:55:06 -04:00
|
|
|
|
2007-12-02 10:58:50 -04:00
|
|
|
for i in range(len(food)):
|
|
|
|
print food[i]
|
|
|
|
|
|
|
|
As opposed to the cleaner, Pythonic method::
|
|
|
|
|
|
|
|
for piece in food:
|
|
|
|
print piece
|
|
|
|
|
2007-08-17 03:27:11 -03:00
|
|
|
reference count
|
2008-09-14 23:03:05 -03:00
|
|
|
The number of references to an object. When the reference count of an
|
|
|
|
object drops to zero, it is deallocated. Reference counting is
|
|
|
|
generally not visible to Python code, but it is a key element of the
|
|
|
|
:term:`CPython` implementation. The :mod:`sys` module defines a
|
2011-08-18 20:27:00 -03:00
|
|
|
:func:`~sys.getrefcount` function that programmers can call to return the
|
2008-09-14 23:03:05 -03:00
|
|
|
reference count for a particular object.
|
|
|
|
|
2007-08-17 03:27:11 -03:00
|
|
|
__slots__
|
2007-08-17 13:54:59 -03:00
|
|
|
A declaration inside a :term:`new-style class` that saves memory by
|
2007-08-17 03:27:11 -03:00
|
|
|
pre-declaring space for instance attributes and eliminating instance
|
|
|
|
dictionaries. Though popular, the technique is somewhat tricky to get
|
|
|
|
right and is best reserved for rare cases where there are large numbers of
|
|
|
|
instances in a memory-critical application.
|
2009-01-03 16:55:06 -04:00
|
|
|
|
2007-08-17 03:27:11 -03:00
|
|
|
sequence
|
2007-08-17 13:54:59 -03:00
|
|
|
An :term:`iterable` which supports efficient element access using integer
|
2008-09-14 23:03:05 -03:00
|
|
|
indices via the :meth:`__getitem__` special method and defines a
|
|
|
|
:meth:`len` method that returns the length of the sequence.
|
2007-08-17 03:27:11 -03:00
|
|
|
Some built-in sequence types are :class:`list`, :class:`str`,
|
|
|
|
:class:`tuple`, and :class:`unicode`. Note that :class:`dict` also
|
|
|
|
supports :meth:`__getitem__` and :meth:`__len__`, but is considered a
|
|
|
|
mapping rather than a sequence because the lookups use arbitrary
|
2007-08-17 13:54:59 -03:00
|
|
|
:term:`immutable` keys rather than integers.
|
2007-08-17 03:27:11 -03:00
|
|
|
|
2007-12-02 10:58:50 -04:00
|
|
|
slice
|
2007-12-02 14:17:50 -04:00
|
|
|
An object usually containing a portion of a :term:`sequence`. A slice is
|
2007-12-02 10:58:50 -04:00
|
|
|
created using the subscript notation, ``[]`` with colons between numbers
|
|
|
|
when several are given, such as in ``variable_name[1:3:5]``. The bracket
|
|
|
|
(subscript) notation uses :class:`slice` objects internally (or in older
|
|
|
|
versions, :meth:`__getslice__` and :meth:`__setslice__`).
|
|
|
|
|
2008-12-05 11:29:39 -04:00
|
|
|
special method
|
|
|
|
A method that is called implicitly by Python to execute a certain
|
|
|
|
operation on a type, such as addition. Such methods have names starting
|
|
|
|
and ending with double underscores. Special methods are documented in
|
|
|
|
:ref:`specialnames`.
|
|
|
|
|
2007-12-02 10:58:50 -04:00
|
|
|
statement
|
|
|
|
A statement is part of a suite (a "block" of code). A statement is either
|
|
|
|
an :term:`expression` or a one of several constructs with a keyword, such
|
2011-08-18 20:27:00 -03:00
|
|
|
as :keyword:`if`, :keyword:`while` or :keyword:`for`.
|
|
|
|
|
|
|
|
struct sequence
|
|
|
|
A tuple with named elements. Struct sequences expose an interface similiar
|
|
|
|
to :term:`named tuple` in that elements can either be accessed either by
|
|
|
|
index or as an attribute. However, they do not have any of the named tuple
|
|
|
|
methods like :meth:`~collections.somenamedtuple._make` or
|
|
|
|
:meth:`~collections.somenamedtuple._asdict`. Examples of struct sequences
|
|
|
|
include :data:`sys.float_info` and the return value of :func:`os.stat`.
|
2007-12-02 10:58:50 -04:00
|
|
|
|
2008-09-14 23:19:53 -03:00
|
|
|
triple-quoted string
|
|
|
|
A string which is bound by three instances of either a quotation mark
|
|
|
|
(") or an apostrophe ('). While they don't provide any functionality
|
|
|
|
not available with single-quoted strings, they are useful for a number
|
|
|
|
of reasons. They allow you to include unescaped single and double
|
|
|
|
quotes within a string and they can span multiple lines without the
|
|
|
|
use of the continuation character, making them especially useful when
|
|
|
|
writing docstrings.
|
|
|
|
|
2007-08-17 03:27:11 -03:00
|
|
|
type
|
|
|
|
The type of a Python object determines what kind of object it is; every
|
|
|
|
object has a type. An object's type is accessible as its
|
|
|
|
:attr:`__class__` attribute or can be retrieved with ``type(obj)``.
|
2008-09-14 23:03:05 -03:00
|
|
|
|
2010-01-11 19:17:10 -04:00
|
|
|
view
|
|
|
|
The objects returned from :meth:`dict.viewkeys`, :meth:`dict.viewvalues`,
|
|
|
|
and :meth:`dict.viewitems` are called dictionary views. They are lazy
|
|
|
|
sequences that will see changes in the underlying dictionary. To force
|
|
|
|
the dictionary view to become a full list use ``list(dictview)``. See
|
|
|
|
:ref:`dict-views`.
|
|
|
|
|
2008-09-14 23:03:05 -03:00
|
|
|
virtual machine
|
|
|
|
A computer defined entirely in software. Python's virtual machine
|
|
|
|
executes the :term:`bytecode` emitted by the bytecode compiler.
|
2009-01-03 16:55:06 -04:00
|
|
|
|
2007-08-17 03:27:11 -03:00
|
|
|
Zen of Python
|
|
|
|
Listing of Python design principles and philosophies that are helpful in
|
|
|
|
understanding and using the language. The listing can be found by typing
|
|
|
|
"``import this``" at the interactive prompt.
|