mirror of
https://github.com/luau-lang/luau.git
synced 2024-12-13 13:30:40 +00:00
Correct table.getn/foreach deprecation RFC (#848)
It looks like all three functions actually have been deprecated in Lua 5.1, and removed in Lua 5.2. We do not plan to remove them to retain backwards compatibility, but the RFC should be more precise.
This commit is contained in:
parent
aef99ae0d4
commit
6601c41bff
1 changed files with 1 additions and 3 deletions
|
@ -6,12 +6,10 @@ Mark table.getn/foreach/foreachi as deprecated
|
|||
|
||||
## Motivation
|
||||
|
||||
`table.getn` was deprecated in Lua 5.1 that Luau is based on.
|
||||
`table.getn`, `table.foreach` and `table.foreachi` were deprecated in Lua 5.1 that Luau is based on, and removed in Lua 5.2.
|
||||
|
||||
`table.getn(x)` is equivalent to `rawlen(x)` when `x` is a table; when `x` is not a table, `table.getn` produces an error. It's difficult to imagine code where `table.getn(x)` is better than either `#x` (idiomatic) or `rawlen(x)` (fully compatible replacement). However, `table.getn` is slower and provides yet another way to perform an operation, leading new users of the language to use it unknowingly.
|
||||
|
||||
`table.foreach` and `table.foreachi` were deprecated in Lua 5.2.
|
||||
|
||||
`table.foreach` is equivalent to a `for .. pairs` loop; `table.foreachi` is equivalent to a `for .. ipairs` loop; both may also be replaced by generalized iteration. Both functions are significantly slower than equivalent `for` loop replacements, are more restrictive because the function can't yield, and result in new users (particularly coming from JS background) unknowingly using these thus producing non-idiomatic non-performant code.
|
||||
|
||||
In both cases, the functions bring no value over other library or language alternatives, and thus just serve as a distraction.
|
||||
|
|
Loading…
Reference in a new issue