3 – Интерфейс программирования приложений (API)

В этой главе рассматривается C API языка Lua. С помощью этого набора C-функций хост-программа может осуществлять доступ к среде и функциональности Lua. Все функции API и соответствующие типы и константы описаны в заголовочном файле lua.h.

Хотя мы применяем термин «функция» к элементам API, по поведению они напоминают макросы. Все функции API, как и в случае с макросами, используют свои аргументы только один раз (за исключением первого аргумента, который всегда представляет собой состояние Lua) и не содержат скрытых побочных эффектов.

Как и большинство C -библиотек, функции API Lua не проверяют свои входные параметры на допустимость и непротиворечивость. Однако, вы можете добавить такую проверку, изменив макрос luai_apicheck в заголовочном файле luaconf.h с последующей перекомпиляцией Lua.