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)

   Retornar 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.

   O docstring e o nome da função são recuperados do objeto de código.
   * __ módulo __ * é 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: c:func: *PyFunction_New*, mas também permite configurar o
   atributo` *__qualname__`* do objeto da função. * Nomname * 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.*

   Retornar o argumento os valores padrões 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ões para o objeto de função *op*.
   *Padrões* deve ser *Py_None* ou uma tupla.

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

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

   Retornar 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*.
   *Fechamento* 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)

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

int PyFunction_SetAnnotations(PyObject *op, PyObject *annotations)

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

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