locals() Namespace local
Última atualização: 2026-09-22
locals() Namespace local
locals() retorna o dicionário do namespace local do escopo atual.
| Categoria | Funções internas |
|---|---|
| Tipo | Função interna |
| Versão do Python | all |
📝 Sintaxe
locals()Retorno：Returns the local namespace dict of the current scope.
▶ Exemplo
Edite o código, clique em Executar e veja o resultado no painel de saída:
Saída：
['a']🏷️ Funções internas relacionadas
💡 Casos relacionados
Mais estudos de caso em breve — aguarde.
❓ Perguntas frequentes
QO que locals() retorna dentro de uma função?
ARetorna o dicionário de variáveis locais do escopo atual da função, incluindo todas as variáveis locais definidas (e os parâmetros).
QNo topo de um módulo, locals() e globals() são iguais?
ASim; no topo de um módulo 'local é global', e ambos retornam o mesmo dicionário.
QPosso mudar uma variável local com locals()['x'] = 1?
AModificar o dicionário retornado dentro de uma função normalmente não muda de verdade a variável local (no CPython, dentro de uma função locals() retorna um snapshot); não dependa disso.
QPara que serve locals()?
AVer rapidamente todas as variáveis do escopo atual em depuração, ou passar com eval/exec um namespace local para controlar o ambiente de execução.
