blob: 51a1c262d685fa07befd87fe0fdbf12a70fd39fa [file] [log] [blame]
Georg Brandl116aa622007-08-15 14:28:22 +00001Built-in Constants
2==================
3
4A small number of constants live in the built-in namespace. They are:
5
Georg Brandl116aa622007-08-15 14:28:22 +00006.. data:: False
7
Georg Brandl48310cd2009-01-03 21:18:54 +00008 The false value of the :class:`bool` type. Assignments to ``False``
Christian Heimes5b5e81c2007-12-31 16:14:33 +00009 are illegal and raise a :exc:`SyntaxError`.
Georg Brandl116aa622007-08-15 14:28:22 +000010
Georg Brandl116aa622007-08-15 14:28:22 +000011
12.. data:: True
13
Georg Brandl48310cd2009-01-03 21:18:54 +000014 The true value of the :class:`bool` type. Assignments to ``True``
Christian Heimes5b5e81c2007-12-31 16:14:33 +000015 are illegal and raise a :exc:`SyntaxError`.
Georg Brandl116aa622007-08-15 14:28:22 +000016
Georg Brandl116aa622007-08-15 14:28:22 +000017
18.. data:: None
19
20 The sole value of :attr:`types.NoneType`. ``None`` is frequently used to
21 represent the absence of a value, as when default arguments are not passed to a
Christian Heimes5b5e81c2007-12-31 16:14:33 +000022 function. Assignments to ``None`` are illegal and raise a :exc:`SyntaxError`.
Georg Brandl116aa622007-08-15 14:28:22 +000023
24
25.. data:: NotImplemented
26
27 Special value which can be returned by the "rich comparison" special methods
28 (:meth:`__eq__`, :meth:`__lt__`, and friends), to indicate that the comparison
29 is not implemented with respect to the other type.
30
31
32.. data:: Ellipsis
33
Georg Brandl9499bb72010-08-02 19:35:06 +000034 The same as ``...``. Special value used mostly in conjunction with extended
35 slicing syntax for user-defined container data types.
Georg Brandl96593ed2007-09-07 14:15:41 +000036
37
38.. data:: __debug__
39
Christian Heimes5b5e81c2007-12-31 16:14:33 +000040 This constant is true if Python was not started with an :option:`-O` option.
Christian Heimes5b5e81c2007-12-31 16:14:33 +000041 See also the :keyword:`assert` statement.
Christian Heimes9bd667a2008-01-20 15:14:11 +000042
Georg Brandl0c7ade22010-08-02 19:39:17 +000043
Georg Brandlc589a702010-08-02 19:36:36 +000044.. note::
45
46 The names :data:`None`, :data:`False`, :data:`True` and :data:`__debug__`
47 cannot be reassigned (assignments to them, even as an attribute name, raise
48 :exc:`SyntaxError`), so they can be considered "true" constants.
49
Christian Heimes9bd667a2008-01-20 15:14:11 +000050
51Constants added by the :mod:`site` module
52-----------------------------------------
53
54The :mod:`site` module (which is imported automatically during startup, except
55if the :option:`-S` command-line option is given) adds several constants to the
56built-in namespace. They are useful for the interactive interpreter shell and
57should not be used in programs.
58
Georg Brandlc2a4f4f2009-04-10 09:03:43 +000059.. data:: quit(code=None)
60 exit(code=None)
Christian Heimes9bd667a2008-01-20 15:14:11 +000061
62 Objects that when printed, print a message like "Use quit() or Ctrl-D
63 (i.e. EOF) to exit", and when called, raise :exc:`SystemExit` with the
Benjamin Peterson8719ad52009-09-11 22:24:02 +000064 specified exit code.
Christian Heimes9bd667a2008-01-20 15:14:11 +000065
66.. data:: copyright
67 license
68 credits
69
70 Objects that when printed, print a message like "Type license() to see the
71 full license text", and when called, display the corresponding text in a
72 pager-like fashion (one screen at a time).
73