Objetos Frame
*************

type PyFrameObject
    * Parte da API Limitada (como uma estrutura opaca).*

   A estrutura C dos objetos usados para descrever objetos frame.

   Não há membros públicos nesta estrutura.

   Alterado na versão 3.11: Os membros dessa estrutura foram removidos
   da API C pública. Consulte a entrada O Que há de Novo para
   detalhes.

As funções "PyEval_GetFrame()" e "PyThreadState_GetFrame()" podem ser
utilizadas para obter um objeto frame.

Veja também Reflexão.

PyTypeObject PyFrame_Type

   O tipo de objetos frame. É o mesmo objeto que "types.FrameType" na
   camada Python.

   Alterado na versão 3.11: Anteriormente, este tipo só estava
   disponível após incluir "<frameobject.h>".

int PyFrame_Check(PyObject *obj)

   Retorna diferente de zero se *obj* é um objeto frame

   Alterado na versão 3.11: Anteriormente, esta função só estava
   disponível após incluir "<frameobject.h>".

PyFrameObject *PyFrame_GetBack(PyFrameObject *frame)

   Obtém o *frame* próximo ao quadro externo.

   Retorna uma *referência forte* ou "NULL" se *frame* não tiver
   quadro externo.

   Novo na versão 3.9.

PyObject *PyFrame_GetBuiltins(PyFrameObject *frame)

   Obtém o atributo "f_builtins" do *frame*.

   Retorna uma *referência forte*. O resultado não pode ser "NULL".

   Novo na versão 3.11.

PyCodeObject *PyFrame_GetCode(PyFrameObject *frame)
    * Parte da ABI Estável desde a versão 3.10.*

   Obtém o código de *frame*.

   Retorna uma *referência forte*.

   O resultado (código do frame) não pode ser "NULL".

   Novo na versão 3.9.

PyObject *PyFrame_GetGenerator(PyFrameObject *frame)

   Obtém o gerador, corrotina ou gerador assíncrono que possui este
   frame, ou "NULL" se o frame não pertence a um gerador. Não levanta
   exceção, mesmo que o valor retornado seja "NULL".

   Retorna uma *referência forte*, ou "NULL".

   Novo na versão 3.11.

PyObject *PyFrame_GetGlobals(PyFrameObject *frame)

   Obtenha o atributo "f_globals" do *frame*.

   Retorna uma *referência forte*. O resultado não pode ser "NULL".

   Novo na versão 3.11.

int PyFrame_GetLasti(PyFrameObject *frame)

   Obtenha o atributo "f_lasti" do *frame*.

   Retorna -1 se "frame.f_lasti" é "None".

   Novo na versão 3.11.

PyObject *PyFrame_GetLocals(PyFrameObject *frame)

   Get the *frame*'s "f_locals" attribute ("dict").

   Retorna uma *referência forte*.

   Novo na versão 3.11.

int PyFrame_GetLineNumber(PyFrameObject *frame)
    * Parte da ABI Estável desde a versão 3.10.*

   Retorna o número da linha do *frame* atualmente em execução.
