debug.getlocal
Lua function

debug.getlocal

Summary

Returns name and value of a local variable

Prototype

name, val = debug.getlocal (level, local)



Description

Returns the name and value of the local variable with the index 'local' of the function at 'level' on the stack.
See also debug.setlocal .


function f (a, b)
local c = 11
local i = 1

repeat
  name, val = debug.getlocal (1, i)
  if name then
    print ("index", i, name, "=", val)
    i = i + 1
  end -- if
until not name

end -- function f

f (22, 33)

 -->

index 1 a = 22
index 2 b = 33
index 3 c = 11
index 4 i = 4



See Also ...

Topics

DOC_lua_base Lua base functions
DOC_lua_bc Lua bc (big number) functions
DOC_lua_bit Lua bit manipulation functions
DOC_lua_coroutines Lua coroutine functions
DOC_lua_debug Lua debug functions
DOC_lua_io Lua io functions
DOC_lua_math Lua math functions
DOC_lua_os Lua os functions
DOC_lua_package Lua package functions
DOC_lua_rex Lua PCRE regular expression functions
DOC_lua Lua script extensions
DOC_lua_string Lua string functions
DOC_lua_tables Lua table functions
DOC_lua_utils Lua utilities
DOC_scripting Scripting

Lua functions

LUA_debug.debug debug.debug (Enters interactive debugging)
LUA_debug.getfenv debug.getfenv (Returns the environment of an object)
LUA_debug.gethook debug.gethook (Returns the current hook settings)
LUA_debug.getinfo debug.getinfo (Returns a table with information about a function)
LUA_debug.getmetatable debug.getmetatable (Returns the metatable of the given object)
LUA_debug.getregistry debug.getregistry (Returns the registry table)
LUA_debug.getupvalue debug.getupvalue (Returns the name and value of an upvalue)
LUA_debug.setfenv debug.setfenv (Sets the environment of an object)
LUA_debug.sethook debug.sethook (Sets a debug hook function)
LUA_debug.setlocal debug.setlocal (Sets the value of the local variable)
LUA_debug.setmetatable debug.setmetatable (Sets the metatable for an object)
LUA_debug.setupvalue debug.setupvalue (Sets an upvalue for a function)
LUA_debug.traceback debug.traceback (Returns a string with a traceback of the stack call)

(Help topic: lua=debug.getlocal)

DOC_contents Documentation contents page