Mercurial > cpython-lru_cache-weakref
diff Doc/api/api.tex @ 14337:3b84c5ff89da legacy-trunk
Document PyImport_AppendInittab(), PyImport_ExtendInittab(), and
struct _inittab.
This closes SourceForge bug #111499.
| author | Fred Drake <fdrake@acm.org> |
|---|---|
| date | Fri, 01 Sep 2000 05:30:00 +0000 |
| parents | 6dee1985c681 |
| children | 2de1fb5302ed |
line wrap: on
line diff
--- a/Doc/api/api.tex Fri Sep 01 04:01:55 2000 +0000 +++ b/Doc/api/api.tex Fri Sep 01 05:30:00 2000 +0000 @@ -1238,7 +1238,7 @@ This is the structure type definition for frozen module descriptors, as generated by the \program{freeze}\index{freeze utility} utility (see \file{Tools/freeze/} in the Python source distribution). Its -definition is: +definition, found in \file{Include/import.h}, is: \begin{verbatim} struct _frozen { @@ -1257,6 +1257,44 @@ dynamically created collection of frozen modules. \end{cvardesc} +\begin{cfuncdesc}{int}{PyImport_AppendInittab}{char *name, + void (*initfunc)(void)} +Add a single module to the existing table of built-in modules. This +is a convenience wrapper around \cfunction{PyImport_ExtendInittab()}, +returning \code{-1} if the table could not be extended. The new +module can be imported by the name \var{name}, and uses the function +\var{initfunc} as the initialization function called on the first +attempted import. This should be called before +\cfunction{Py_Initialize()}. +\end{cfuncdesc} + +\begin{ctypedesc}[_inittab]{struct _inittab} +Structure describing a single entry in the list of built-in modules. +Each of these structures gives the name and initialization function +for a module built into the interpreter. Programs which embed Python +may use an array of these structures in conjunction with +\cfunction{PyImport_ExtendInittab()} to provide additional built-in +modules. The structure is defined in \file{Include/import.h} as: + +\begin{verbatim} +struct _inittab { + char *name; + void (*initfunc)(void); +}; +\end{verbatim} +\end{ctypedesc} + +\begin{cfuncdesc}{int}{PyImport_ExtendInittab}{struct _inittab *newtab} +Add a collection of modules to the table of built-in modules. The +\var{newtab} array must end with a sentinel entry which contains +\NULL{} for the \member{name} field; failure to provide the sentinel +value can result in a memory fault. Returns \code{0} on success or +\code{-1} if insufficient memory could be allocated to extend the +internal table. In the event of failure, no modules are added to the +internal table. This should be called before +\cfunction{Py_Initialize()}. +\end{cfuncdesc} + \chapter{Abstract Objects Layer \label{abstract}}
