mirrors/cpython
1
0
Fork 0
mirror of https://github.com/python/cpython.git synced 2025-11-13 07:26:31 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions 9

Removed reference to the out-of-date (and not very useful)

Browse source 
Objects/xxobject.c example.

Updated the discussion of type checking to refer to
PyObject_TypeCheck.
This commit is contained in:
Jim Fulton 2003-05-16 13:32:59 +00:00
parent ac826aac28
commit aea763bde7
1 changed files with 9 additions and 23 deletions
Download patch file Download diff file Expand all files Collapse all files

32
Doc/ext/newtypes.tex
View file

@ -1334,17 +1334,10 @@ Collection}{../api/supporting-cycle-detection.html} in the
\subsection{More Suggestions} \subsection{More Suggestions}
Remember that you can omit most of these functions, in which case you Remember that you can omit most of these functions, in which case you
provide \code{0} as a value. provide \code{0} as a value. There are type definitions for each of
the functions you must provide. They are in \file{object.h} in the
In the \file{Objects} directory of the Python source distribution, Python include directory that comes with the source distribution of
there is a file \file{xxobject.c}, which is intended to be used as a Python.
template for the implementation of new types. One useful strategy
for implementing a new type is to copy and rename this file, then
read the instructions at the top of it.
There are type definitions for each of the functions you must
provide. They are in \file{object.h} in the Python include
directory that comes with the source distribution of Python.
In order to learn how to implement any specific method for your new In order to learn how to implement any specific method for your new
datatype, do the following: Download and unpack the Python source datatype, do the following: Download and unpack the Python source
@ -1353,20 +1346,13 @@ C source files for \code{tp_} plus the function you want (for
example, \code{tp_print} or \code{tp_compare}). You will find example, \code{tp_print} or \code{tp_compare}). You will find
examples of the function you want to implement. examples of the function you want to implement.
When you need to verify that the type of an object is indeed the When you need to verify that an object is an instance of the type
object you are implementing and if you use xxobject.c as an starting you are implementing, use the \cfunction{PyObject_TypeCheck} function.
template for your implementation, then there is a macro defined for A sample of its use might be something like the following:
this purpose. The macro definition will look something like this:
\begin{verbatim} \begin{verbatim}
#define is_newdatatypeobject(v) ((v)->ob_type == &Newdatatypetype) if (! PyObject_TypeCheck(some_object, &MyType) {
\end{verbatim} PyErr_SetString(PyExc_TypeError, "arg #1 not a mything");
And, a sample of its use might be something like the following:
\begin{verbatim}
if (!is_newdatatypeobject(objp1) {
PyErr_SetString(PyExc_TypeError, "arg #1 not a newdatatype");
return NULL; return NULL;
} }
\end{verbatim} \end{verbatim}