| \section{\module{new} --- |
| Runtime implementation object creation} |
| |
| \declaremodule{builtin}{new} |
| \sectionauthor{Moshe Zadka}{mzadka@geocities.com} |
| \modulesynopsis{Interface to the creation of runtime implementation objects.} |
| |
| |
| The \module{new} module allows an interface to the interpreter object |
| creation functions. This is for use primarily in marshal-type functions, |
| when a new object needs to be created ``magically'' and not by using the |
| regular creation functions. This module provides a low-level interface |
| to the interpreter, so care must be exercised when using this module. |
| |
| The \module{new} module defines the following functions: |
| |
| \begin{funcdesc}{instance}{class, dict} |
| This function creates an instance of \var{class} with dictionary |
| \var{dict} without calling the \method{__init__()} constructor. Note that |
| there are no guarantees that the object will be in a consistent state. |
| \end{funcdesc} |
| |
| \begin{funcdesc}{instancemethod}{function, instance, class} |
| This function will return a method object, bound to \var{instance}, or |
| unbound if \var{instance} is \code{None}. \var{function} must be |
| callable, and \var{instance} must be an instance object or |
| \code{None}. |
| \end{funcdesc} |
| |
| \begin{funcdesc}{function}{code, globals\optional{, name\optional{argdefs}}} |
| Returns a (Python) function with the given code and globals. If |
| \var{name} is given, it must be a string or \code{None}. If it is a |
| string, the function will have the given name, otherwise the function |
| name will be taken from \code{\var{code}.co_name}. If |
| \var{argdefs} is given, it must be a tuple and will be used to the |
| determine the default values of parameters. |
| \end{funcdesc} |
| |
| \begin{funcdesc}{code}{argcount, nlocals, stacksize, flags, codestring, |
| constants, names, varnames, filename, name, firstlineno, |
| lnotab} |
| This function is an interface to the \cfunction{PyCode_New()} C |
| function. |
| %XXX This is still undocumented!!!!!!!!!!! |
| \end{funcdesc} |
| |
| \begin{funcdesc}{module}{name} |
| This function returns a new module object with name \var{name}. |
| \var{name} must be a string. |
| \end{funcdesc} |
| |
| \begin{funcdesc}{classobj}{name, baseclasses, dict} |
| This function returns a new class object, with name \var{name}, derived |
| from \var{baseclasses} (which should be a tuple of classes) and with |
| namespace \var{dict}. |
| \end{funcdesc} |