1
0
mirror of https://github.com/SquidDev-CC/CC-Tweaked synced 2024-12-15 12:40:30 +00:00
CC-Tweaked/doc/guides/feature_compat.md

12 KiB

module: [kind=guide] feature_compat

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.