Repo refactor: rename "website" to "docs"

This commit is contained in:
Zef Hemel
2026-06-23 09:12:24 +02:00
parent 1b3e86d960
commit e7ccdc2883
226 changed files with 1 additions and 1 deletions
+66
View File
@@ -0,0 +1,66 @@
#api/syscall
The Lua API provides functions for parsing and evaluating Lua code.
### lua.parseBlock(code)
Parses a string of Lua code (a block of statements) into an abstract syntax tree (AST).
Parameters:
- `code`: The Lua code to parse
Returns a LuaBlock object representing the parsed code.
Example:
```lua
local ast = lua.parseBlock("print('Hello')")
-- ast contains the parsed syntax tree
```
> **note** Note
> `lua.parse` is a deprecated alias for `lua.parseBlock` and is kept for backwards compatibility.
### lua.parseExpression(expression)
Parses a Lua expression into an abstract syntax tree (AST).
Parameters:
- `expression`: The Lua expression to parse
Returns a LuaExpression object representing the parsed expression.
Example:
```lua
local expr = lua.parseExpression("1 + 2 * 3")
-- expr contains the parsed expression tree
```
### lua.evalExpression(expression)
Evaluates a Lua expression and returns its result.
Parameters:
- `expression`: The Lua expression to evaluate
Returns the result of evaluating the expression.
Example:
```lua
local result = lua.evalExpression("1 + 2 * 3")
print(result) -- prints: 7
```
### lua.prettyPrintBlock(block, options?)
Pretty-prints a parsed Lua block AST (as returned by [[#lua.parseBlock(code)]]) back to formatted Lua source.
The optional `options` table accepts `indentWidth` (number, default `2`), `quote` (`"double"` or `"single"`, default `"double"`), and `trailingComma` (boolean, default `true`). Comments are not preserved.
Example:
```lua
local formatted = lua.prettyPrintBlock(lua.parseBlock("if a then return 1 end"))
```
### lua.prettyPrintExpression(expression, options?)
Pretty-prints a parsed Lua expression AST (as returned by [[#lua.parseExpression(expression)]]) back to formatted Lua source. Accepts the same `options` table as [[#lua.prettyPrintBlock(block, options?)]].
Example:
```lua
local formatted = lua.prettyPrintExpression(lua.parseExpression("{a=1,b=2}"))
```