cpython/Doc/c-api/concrete.rst

117 lines
2.0 KiB
ReStructuredText
Raw Normal View History

2007-08-15 11:28:22 -03:00
.. highlightlang:: c
.. _concrete:
**********************
Concrete Objects Layer
**********************
The functions in this chapter are specific to certain Python object types.
Passing them an object of the wrong type is not a good idea; if you receive an
object from a Python program and you are not sure that it has the right type,
you must perform a type check first; for example, to check that an object is a
dictionary, use :c:func:`PyDict_Check`. The chapter is structured like the
2007-08-15 11:28:22 -03:00
"family tree" of Python object types.
.. warning::
While the functions described in this chapter carefully check the type of the
objects which are passed in, many of them do not check for *NULL* being passed
instead of a valid object. Allowing *NULL* to be passed in can cause memory
access violations and immediate termination of the interpreter.
.. _fundamental:
Fundamental Objects
===================
This section describes Python type objects and the singleton object ``None``.
2008-01-20 05:30:57 -04:00
.. toctree::
2007-08-15 11:28:22 -03:00
2008-01-20 05:30:57 -04:00
type.rst
none.rst
2007-08-15 11:28:22 -03:00
.. _numericobjects:
Numeric Objects
===============
.. index:: object: numeric
2008-01-20 05:30:57 -04:00
.. toctree::
2007-08-15 11:28:22 -03:00
2008-01-20 05:30:57 -04:00
long.rst
bool.rst
float.rst
complex.rst
2007-08-15 11:28:22 -03:00
.. _sequenceobjects:
Sequence Objects
================
.. index:: object: sequence
Generic operations on sequence objects were discussed in the previous chapter;
this section deals with the specific kinds of sequence objects that are
intrinsic to the Python language.
2008-01-05 17:16:33 -04:00
.. XXX sort out unicode, str, bytes and bytearray
2007-08-15 11:28:22 -03:00
2008-01-20 05:30:57 -04:00
.. toctree::
2007-08-15 11:28:22 -03:00
bytes.rst
bytearray.rst
2008-01-20 05:30:57 -04:00
unicode.rst
tuple.rst
list.rst
2007-08-15 11:28:22 -03:00
2008-01-20 05:30:57 -04:00
.. _mapobjects:
2007-08-15 11:28:22 -03:00
Container Objects
=================
2007-08-15 11:28:22 -03:00
2008-01-20 05:30:57 -04:00
.. index:: object: mapping
2007-08-15 11:28:22 -03:00
2008-01-20 05:30:57 -04:00
.. toctree::
2007-08-15 11:28:22 -03:00
2008-01-20 05:30:57 -04:00
dict.rst
set.rst
2007-08-15 11:28:22 -03:00
2008-01-20 05:30:57 -04:00
.. _otherobjects:
2007-08-15 11:28:22 -03:00
Function Objects
================
2007-08-15 11:28:22 -03:00
2008-01-20 05:30:57 -04:00
.. toctree::
function.rst
method.rst
cell.rst
code.rst
Other Objects
=============
.. toctree::
2008-01-20 05:30:57 -04:00
file.rst
module.rst
iterator.rst
descriptor.rst
slice.rst
memoryview.rst
2008-01-20 05:30:57 -04:00
weakref.rst
capsule.rst
2008-01-20 05:30:57 -04:00
gen.rst
datetime.rst