mirrors/cpython
1
0
Fork 0
mirror of https://github.com/python/cpython.git synced 2025-11-03 03:22:27 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions 8

Issue #23710: Merge from 3.5

Browse source
This commit is contained in:
Berker Peksag 2016-08-03 12:59:16 +03:00
commit 9f4712af25
1 changed files with 9 additions and 5 deletions
Download patch file Download diff file Expand all files Collapse all files

14
Doc/extending/newtypes.rst
View file

@ -52,11 +52,15 @@ The first bit that will be new is::
} noddy_NoddyObject; } noddy_NoddyObject;
This is what a Noddy object will contain---in this case, nothing more than what This is what a Noddy object will contain---in this case, nothing more than what
every Python object contains---a refcount and a pointer to a type object. every Python object contains---a field called ``ob_base`` of type
These are the fields the ``PyObject_HEAD`` macro brings in. The reason for the :c:type:`PyObject`. :c:type:`PyObject` in turn, contains an ``ob_refcnt``
macro is to standardize the layout and to enable special debugging fields in field and a pointer to a type object. These can be accessed using the macros
debug builds. Note that there is no semicolon after the ``PyObject_HEAD`` :c:macro:`Py_REFCNT` and :c:macro:`Py_TYPE` respectively. These are the fields
macro; one is included in the macro definition. Be wary of adding one by the :c:macro:`PyObject_HEAD` macro brings in. The reason for the macro is to
standardize the layout and to enable special debugging fields in debug builds.
Note that there is no semicolon after the :c:macro:`PyObject_HEAD` macro;
one is included in the macro definition. Be wary of adding one by
accident; it's easy to do from habit, and your compiler might not complain, accident; it's easy to do from habit, and your compiler might not complain,
but someone else's probably will! (On Windows, MSVC is known to call this an but someone else's probably will! (On Windows, MSVC is known to call this an
error and refuse to compile the code.) error and refuse to compile the code.)