mirror of
https://github.com/SquidDev-CC/CC-Tweaked
synced 2024-09-12 23:39:42 +00:00
5bb2e8e8cd
- Timeouts are now driven by an interrupt system, rather than polling. While we do not impose memory limits, this should close #1333. - Update the table library to largely match Lua 5.4: - Add table.move - Table methods (with the exception of foreach/foreachi) now use metamethods (closes #1088). There's still some remaining quirks (for instance, table.insert accepts values out-of-bounds), but I think that's fine. - Cobalt's threaded-coroutine system is gone (load now supports yielding), so we no longer track coroutine metrics. - Type errors now use __name. See #1355, though this does not apply to CC methods (either on the Java or CraftOS side), so is not enough to resolve it. See https://github.com/SquidDev/Cobalt/compare/v0.6.0...v0.7.0 for the full delta.
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 | ❌ | Deprecated in Lua 5.3. `ipairs` uses `__len`/`__index` instead. |
|
|
| `__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 | ❌ | Removed in Lua 5.4 |
|
|
| 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` | ✔ | |
|
|
|
|
## 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. |
|