debug.traceback
Lua function

debug.traceback

Summary

Returns a string with a traceback of the stack call

Prototype

s = debug.traceback ( [thread,] message [, level])


Description

Returns a string with a traceback of the stack call. An optional message string is prepended to the beginning of the traceback message.


function f ()
  function g ()
  print (debug.traceback ("traceback in g"))
  end -- g
  g ()
end -- f

f ()

 -->
 
traceback in g
stack traceback:
        stdin:3: in function `g'
        stdin:6: in function `f'
        stdin:1: in main chunk
        [C]: ?


You can optionally supply a thread (coroutine) to be traced. This is useful if you get an error after calling coroutine.resume.

An optional level number tells at which level to start the tracekback - the default is 1 which is the function calling traceback.

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.getlocal debug.getlocal (Returns name and value of a local variable)
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)

(Help topic: lua=debug.traceback)

DOC_contents Documentation contents page