mirror of
https://github.com/SquidDev-CC/CC-Tweaked
synced 2024-12-15 12:40:30 +00:00
895bc7721a
This adds SPDX license headers to all source code files, following the REUSE[1] specification. This does not include any asset files (such as generated JSON files, or textures). While REUSE does support doing so with ".license" files, for now we define these licences using the .reuse/dep5 file. [1]: https://reuse.software/
102 lines
12 KiB
Markdown
102 lines
12 KiB
Markdown
---
|
|
module: [kind=reference] feature_compat
|
|
---
|
|
|
|
<!--
|
|
SPDX-FileCopyrightText: 2022 The CC: Tweaked Developers
|
|
|
|
SPDX-License-Identifier: LicenseRef-CCPL
|
|
-->
|
|
|
|
# Lua 5.2/5.3 features in CC: Tweaked
|
|
CC: Tweaked is based off of the Cobalt Lua runtime, which uses Lua 5.1. However, Cobalt and CC:T implement additional features from Lua 5.2 and 5.3 (as well as some deprecated 5.0 features) that are not available in base 5.1. This page lists all of the compatibility for these newer versions.
|
|
|
|
## Lua 5.2
|
|
| Feature | Supported? | Notes |
|
|
|---------------------------------------------------------------|------------|-------------------------------------------------------------------|
|
|
| `goto`/labels | ❌ | |
|
|
| `_ENV` | 🔶 | The `_ENV` global points to `getfenv()`, but it cannot be set. |
|
|
| `\z` escape | ✔ | |
|
|
| `\xNN` escape | ✔ | |
|
|
| Hex literal fractional/exponent parts | ✔ | |
|
|
| Empty statements | ❌ | |
|
|
| `__len` metamethod | ✔ | |
|
|
| `__ipairs` metamethod | ❌ | |
|
|
| `__pairs` metamethod | ✔ | |
|
|
| `bit32` library | ✔ | |
|
|
| `collectgarbage` isrunning, generational, incremental options | ❌ | `collectgarbage` does not exist in CC:T. |
|
|
| New `load` syntax | ✔ | |
|
|
| `loadfile` mode parameter | ✔ | Supports both 5.1 and 5.2+ syntax. |
|
|
| Removed `loadstring` | 🔶 | Only if `disable_lua51_features` is enabled in the configuration. |
|
|
| Removed `getfenv`, `setfenv` | 🔶 | Only if `disable_lua51_features` is enabled in the configuration. |
|
|
| `rawlen` function | ✔ | |
|
|
| Negative index to `select` | ✔ | |
|
|
| Removed `unpack` | 🔶 | Only if `disable_lua51_features` is enabled in the configuration. |
|
|
| Arguments to `xpcall` | ❌ | |
|
|
| Second return value from `coroutine.running` | ❌ | |
|
|
| Removed `module` | ✔ | |
|
|
| `package.loaders` -> `package.searchers` | ❌ | |
|
|
| Second argument to loader functions | ✔ | |
|
|
| `package.config` | ✔ | |
|
|
| `package.searchpath` | ✔ | |
|
|
| Removed `package.seeall` | ✔ | |
|
|
| `string.dump` on functions with upvalues (blanks them out) | ✔ | |
|
|
| `string.rep` separator | ❌ | |
|
|
| `%g` match group | ❌ | |
|
|
| Removal of `%z` match group | ❌ | |
|
|
| Removed `table.maxn` | 🔶 | Only if `disable_lua51_features` is enabled in the configuration. |
|
|
| `table.pack`/`table.unpack` | ✔ | |
|
|
| `math.log` base argument | ✔ | |
|
|
| Removed `math.log10` | 🔶 | Only if `disable_lua51_features` is enabled in the configuration. |
|
|
| `*L` mode to `file:read` | ✔ | |
|
|
| `os.execute` exit type + return value | ❌ | `os.execute` does not exist in CC:T. |
|
|
| `os.exit` close argument | ❌ | `os.exit` does not exist in CC:T. |
|
|
| `istailcall` field in `debug.getinfo` | ❌ | |
|
|
| `nparams` field in `debug.getinfo` | ✔ | |
|
|
| `isvararg` field in `debug.getinfo` | ✔ | |
|
|
| `debug.getlocal` negative indices for varargs | ❌ | |
|
|
| `debug.getuservalue`/`debug.setuservalue` | ❌ | Userdata are rarely used in CC:T, so this is not necessary. |
|
|
| `debug.upvalueid` | ✔ | |
|
|
| `debug.upvaluejoin` | ✔ | |
|
|
| Tail call hooks | ❌ | |
|
|
| `=` prefix for chunks | ✔ | |
|
|
| Yield across C boundary | ✔ | |
|
|
| Removal of ambiguity error | ❌ | |
|
|
| Identifiers may no longer use locale-dependent letters | ✔ | |
|
|
| Ephemeron tables | ❌ | |
|
|
| Identical functions may be reused | ❌ | |
|
|
| Generational garbage collector | ❌ | Cobalt uses the built-in Java garbage collector. |
|
|
|
|
## Lua 5.3
|
|
| Feature | Supported? | Notes |
|
|
|---------------------------------------------------------------------------------------|------------|---------------------------|
|
|
| Integer subtype | ❌ | |
|
|
| Bitwise operators/floor division | ❌ | |
|
|
| `\u{XXX}` escape sequence | ✔ | |
|
|
| `utf8` library | ✔ | |
|
|
| removed `__ipairs` metamethod | ✔ | |
|
|
| `coroutine.isyieldable` | ❌ | |
|
|
| `string.dump` strip argument | ✔ | |
|
|
| `string.pack`/`string.unpack`/`string.packsize` | ✔ | |
|
|
| `table.move` | ❌ | |
|
|
| `math.atan2` -> `math.atan` | ❌ | |
|
|
| Removed `math.frexp`, `math.ldexp`, `math.pow`, `math.cosh`, `math.sinh`, `math.tanh` | ❌ | |
|
|
| `math.maxinteger`/`math.mininteger` | ❌ | |
|
|
| `math.tointeger` | ❌ | |
|
|
| `math.type` | ❌ | |
|
|
| `math.ult` | ❌ | |
|
|
| Removed `bit32` library | ❌ | |
|
|
| Remove `*` from `file:read` modes | ✔ | |
|
|
| Metamethods respected in `table.*`, `ipairs` | 🔶 | Only `__lt` is respected. |
|
|
|
|
## Lua 5.0
|
|
| Feature | Supported? | Notes |
|
|
|----------------------------------|------------|--------------------------------------------------|
|
|
| `arg` table | 🔶 | Only set in the shell - not used in functions. |
|
|
| `string.gfind` | ✔ | Equal to `string.gmatch`. |
|
|
| `table.getn` | ✔ | Equal to `#tbl`. |
|
|
| `table.setn` | ❌ | |
|
|
| `math.mod` | ✔ | Equal to `math.fmod`. |
|
|
| `table.foreach`/`table.foreachi` | ✔ | |
|
|
| `gcinfo` | ❌ | Cobalt uses the built-in Java garbage collector. |
|