Master programming syntax, solve interactive challenges & run live code in Syntaxis Explore Arena →
menu_book Course Curriculum (Lua) expand_more
Foundations
Local variables Global variables Nil Booleans Numbers Strings Multiple assignment Comments
Control Flow
If elseif While loop Repeat until Numeric for Generic for Break Goto labels Do blocks
Functions
Function definitions Local functions Multiple returns Varargs First-class functions Closures Tail calls Self parameter colon syntax
Tables
Table literals Array-style tables Key-value tables Mixed tables Table.insert Table.remove Table.concat Table.sort
Metatables
Setmetatable __index __newindex __tostring __add __eq __len Rawget rawset
Iterators and Coroutines
Pairs Ipairs Next Custom iterator Coroutine.create Coroutine.resume Coroutine.yield Coroutine.wrap
Modules and Environments
Require Package.path Module return table Local module state _ENV Load Loadfile Dofile
Strings and Patterns
String.find String.match String.gmatch String.gsub Pattern classes Captures Frontier patterns Balanced patterns
Files and Errors
Io.open File read File write Io.lines Error Assert Pcall Xpcall
Advanced Lua
Weak tables Garbage collection Table.pack unpack Utf8 library Os.date Math.random Debug traceback C API concept
Lua / Iterators and Coroutines

Custom iterator

Learn custom iterator in Lua through a focused explanation, a dedicated topic-specific example, an engineering boundary, and a mastery check.

12 min read • Intermediate

custom iterator is an atomic Lua topic inside Iterators and Coroutines. The example uses the named construct directly so you can see its syntax, data flow, and observable behavior.

Read the code by locating the exact feature named custom iterator, then trace the value before and after that feature runs. This lesson is intentionally isolated from neighboring topics: changing identifiers alone would not reproduce the same behavior because the construct itself is different.

Topic-specific example

lua-0044-c7292e65df.lua
lua Try It Live 
local function upto(n)local i=0;return function()i=i+1;if i<=n then return i end end end
for i in upto(3) do print(i) end
Edge case / engineering note

For custom iterator, test the boundary that makes the feature meaningful: invalid input, an empty value, a missing branch, lifecycle/cleanup, or a type/runtime constraint. Do not infer correctness only from the happy path.

Content source & attribution
Original Syntaxis Content · Original Syntaxis Content

Lesson quizzes

Custom iterator Mastery Check →
← PREVIOUS
Next
NEXT →
Coroutine.create