ꦫꦣꦺꦤ꧀ꦄꦤ꧀ꦠꦱꦺꦤ

PATH: usr / share / doc / python-docs-2.7.5 / html / _sources / c-api

.. highlightlang:: c

.. _function-objects:

Function Objects
----------------

.. index:: object: function

There are a few functions specific to Python functions.

.. c:type:: PyFunctionObject

The C structure used for functions.

.. c:var:: PyTypeObject PyFunction_Type

.. index:: single: MethodType (in module types)

This is an instance of :c:type:`PyTypeObject` and represents the Python function
   type.  It is exposed to Python programmers as ``types.FunctionType``.

.. c:function:: int PyFunction_Check(PyObject *o)

Return true if *o* is a function object (has type :c:data:`PyFunction_Type`).
   The parameter must not be *NULL*.

.. c:function:: PyObject* PyFunction_New(PyObject *code, PyObject *globals)

Return a new function object associated with the code object *code*. *globals*
   must be a dictionary with the global variables accessible to the function.

The function's docstring, name and *__module__* are retrieved from the code
   object, the argument defaults and closure are set to *NULL*.

.. c:function:: PyObject* PyFunction_GetCode(PyObject *op)

Return the code object associated with the function object *op*.

.. c:function:: PyObject* PyFunction_GetGlobals(PyObject *op)

Return the globals dictionary associated with the function object *op*.

.. c:function:: PyObject* PyFunction_GetModule(PyObject *op)

Return the *__module__* attribute of the function object *op*. This is normally
   a string containing the module name, but can be set to any other object by
   Python code.

.. c:function:: PyObject* PyFunction_GetDefaults(PyObject *op)

Return the argument default values of the function object *op*. This can be a
   tuple of arguments or *NULL*.

.. c:function:: int PyFunction_SetDefaults(PyObject *op, PyObject *defaults)

Set the argument default values for the function object *op*. *defaults* must be
   *Py_None* or a tuple.

Raises :exc:`SystemError` and returns ``-1`` on failure.

.. c:function:: PyObject* PyFunction_GetClosure(PyObject *op)

Return the closure associated with the function object *op*. This can be *NULL*
   or a tuple of cell objects.

.. c:function:: int PyFunction_SetClosure(PyObject *op, PyObject *closure)

Set the closure associated with the function object *op*. *closure* must be
   *Py_None* or a tuple of cell objects.

Raises :exc:`SystemError` and returns ``-1`` on failure.

[-] string.txt [edit]
[-] long.txt [edit]
[-] tuple.txt [edit]
[-] type.txt [edit]
[-] utilities.txt [edit]
[-] module.txt [edit]
[-] reflection.txt [edit]
[-] list.txt [edit]
[-] buffer.txt [edit]
[-] none.txt [edit]
[-] datetime.txt [edit]
[-] gcsupport.txt [edit]
[-] cobject.txt [edit]
[-] veryhigh.txt [edit]
[-] init.txt [edit]
[+] ..
[-] index.txt [edit]
[-] refcounting.txt [edit]
[-] gen.txt [edit]
[-] dict.txt [edit]
[-] sequence.txt [edit]
[-] weakref.txt [edit]
[-] set.txt [edit]
[-] int.txt [edit]
[-] class.txt [edit]
[-] float.txt [edit]
[-] objimpl.txt [edit]
[-] mapping.txt [edit]
[-] abstract.txt [edit]
[-] import.txt [edit]
[-] method.txt [edit]
[-] complex.txt [edit]
[-] concrete.txt [edit]
[-] iter.txt [edit]
[-] function.txt [edit]
[-] iterator.txt [edit]
[-] unicode.txt [edit]
[-] file.txt [edit]
[-] conversion.txt [edit]
[-] memory.txt [edit]
[-] bool.txt [edit]
[-] object.txt [edit]
[-] bytearray.txt [edit]
[-] marshal.txt [edit]
[-] slice.txt [edit]
[-] descriptor.txt [edit]
[-] arg.txt [edit]
[-] codec.txt [edit]
[-] code.txt [edit]
[-] cell.txt [edit]
[-] number.txt [edit]
[-] objbuffer.txt [edit]
[-] sys.txt [edit]
[-] typeobj.txt [edit]
[-] exceptions.txt [edit]
[-] intro.txt [edit]
[-] allocation.txt [edit]
[-] structures.txt [edit]
[-] capsule.txt [edit]