# 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)

  Get the frame’s `f_builtins` attribute.

  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)

  Get the frame’s `f_globals` attribute.

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

  Novo na versão 3.11.

int PyFrame_GetLasti(PyFrameObject *frame)

  Get the frame’s `f_lasti` attribute.

  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.