Objetos de Função
*****************

Existem algumas funções específicas para as funções do Python.

PyFunctionObject

   A estrutura C usada para funções.

PyTypeObject PyFunction_Type

   Esta é uma instância de: c: type:*PyTypeObject* e representa o tipo
   de função Python. Está exposto aos programadores Python como
   "types.FunctionType".

int PyFunction_Check(PyObject *o)

   Retorna verdadeiro se *o* for um objeto de função (tem tipo: c:
   dados: *PyFunction_Type*). O parâmetro não deve ser "NULL".

PyObject* PyFunction_New(PyObject *code, PyObject *globals)
    *Return value: New reference.*

   Retornar um novo objeto de função associado ao código objeto
   *código*. *Globals* deve ser um dicionário com as variáveis globais
   acessíveis à função.

   A docstring e o nome da função são recuperados do objeto de código.
   *__module__ * é recuperado de *globals*. Os padrões de argumento,
   as anotações e o encerramento são definidos como "NULL".
   *__qualname__* está definido para o mesmo valor que o nome da
   função.

PyObject* PyFunction_NewWithQualName(PyObject *code, PyObject *globals, PyObject *qualname)
    *Return value: New reference.*

   Como "PyFunction_New()", mas também permite configurar o atributo
   "__qualname__" do objeto da função. *qualname* deve ser um objeto
   unicode ou "NULL"; Se "NULL", o atributo "__qualname__" é definido
   como o mesmo valor que o atributo "__name__".

   Novo na versão 3.3.

PyObject* PyFunction_GetCode(PyObject *op)
    *Return value: Borrowed reference.*

   Retornar o objeto de código associado ao objeto de função * op
   >>*<<.

PyObject* PyFunction_GetGlobals(PyObject *op)
    *Return value: Borrowed reference.*

   Retorna o dicionário global associado ao objeto de função * op
   >>*<<.

PyObject* PyFunction_GetModule(PyObject *op)
    *Return value: Borrowed reference.*

   Retorna o atributo * __ módulo __ * do objeto de função * op >>*<<.
   Esta é normalmente uma string contendo o nome do módulo, mas pode
   ser configurada para qualquer outro objeto pelo código Python.

PyObject* PyFunction_GetDefaults(PyObject *op)
    *Return value: Borrowed reference.*

   Retorna o argumento os valores padrão do objeto de função *op*.
   Isso pode ser uma tupla de argumentos ou "NULL".

int PyFunction_SetDefaults(PyObject *op, PyObject *defaults)

   Define o argumento valores padrão para o objeto de função *op*.
   *defaults* deve ser "Py_None" ou uma tupla.

   Eleva: exc:*SystemError* e retorna "-1" em falha.

PyObject* PyFunction_GetClosure(PyObject *op)
    *Return value: Borrowed reference.*

   Retorna o fechamento associado ao objeto de função *op*. Isso pode
   ser "NULL" ou uma tupla de objetos de célula.

int PyFunction_SetClosure(PyObject *op, PyObject *closure)

   Define o fechamento associado ao objeto de função *op*. *closure*
   deve ser "Py_None" ou uma tupla de objetos de célula.

   Eleva: exc:*SystemError* e retorna "-1" em falha.

PyObject *PyFunction_GetAnnotations(PyObject *op)
    *Return value: Borrowed reference.*

   Retorna as anotações do objeto de função *op*. Este pode ser um
   dicionário mutável ou "NULL".

int PyFunction_SetAnnotations(PyObject *op, PyObject *annotations)

   Define as anotações para o objeto de função *op*. *annotations*
   deve ser um dicionário ou "Py_None".

   Eleva: exc:*SystemError* e retorna "-1" em falha.
