Справочное руководство по языку Lua 5.1 :: 3.4 - Псевдо-индексы



3.4 - C - включения

С С-функцией можно ассоциировать некоторые значения, это делается с помощью механизма С-включений. Такие значения называеются внешними значениям и доступны в функции независимо от того, где она вызвана (смотрите lua_pushcclosure).

Откуда бы C-функция не вызывалась, эти внешние значения доступны через специальные псевдо-индексы. Их можно получить с помощью lua_upvalueindex. Первое ассоциированное с функцией значение доступно по индексу lua_upvalueindex(1), и так далее. В случае вызова lua_upvalueindex(n), где nбольше количества внешних значения этой функции, вернется допустимый с точки зрения стека индекс (но он будет указывать неизвестно на что).