lua

notes on lua

lua

notes on lua

lua

comments

• line: -- a comment
• block: --[[ a comment ]]--

variables

• g = "foo": global variable
• local l = "bar": local (block scoped) variable

builtin, operators

unusual ones

• ^ exponent
• ~=: not
• ..: concat
• print(): print to stdout
• pairs(): iterate over table
• ipairs(): iterate over table, stop at first break

idioms

• a and b or c == a ? b : c
• x = x or v == if not x then x = v end

control flow

do

not really control flow, just a new block

do
  -- something
end

if

if condition then
  -- something
elseif condition then
  -- something
else
  -- something
end

while, repeat

-- test before body, repeat until false
while condition do
  -- something
end

-- test after body, repeat until true
repeat
  -- something
until condition

for

-- numeric, step defaults to 1
for i = start,finish,step do
  -- something
end

-- generic, use with iterators
for a,b in x do
  -- something
end

break

• break: jump out of while,repeat, for

functions

-- normal function
function function_name (a, b, ...)
  -- something
  -- access ... with arg[]
  return a, b
end

-- anonymous function, useful in closures
function ()
  return "foo"
end

-- assign function_name to some_table
function some_table.function_name ()
  return "foo"
end

-- locally scoped function
local function function_name ()
  return "foo"
end

tables

• t = {}: empty table
• t = { "foo"="bar" }: t["foo"] = "bar"
• t = { "foo", "bar" }: t[1] = "foo", t[2] = "bar"

errors

• error("some error"): raise an error
• assert(condition, "some error"): assert, raise an error
• pcall(some_function): catch an error, returns true + values or false + error

special tables

ref lua 5.4 index

• arg: table of args, for scripts, functions with variable args
• _G: table holding globals
• coroutine: coroutine functions, create, yield, resume, ...
• table: table manipulation: insert, remove, sort, concat, ...
• string: string manipulation: len, lower, upper, char, byte, sub, rep, reverse, format, find, gsub, gfind, ...
• io: io functions: lines, read, write, input, output, open, flush, close, stdin, stdout, stderr, ...
  • open: return a file handle with functions: lines, read, write, seek, flush close, ...
• os: date, time, difftime, getenv, execute, exit, ...
• math: ...
• utf8: ...
• debug: ...