|
|
@ -2563,8 +2563,8 @@ See also @Lid{luaL_checklstring}, @Lid{luaL_checkstring}, |
|
|
|
and @Lid{luaL_tolstring} in the auxiliary library.) |
|
|
|
|
|
|
|
In general, |
|
|
|
Lua's garbage collection can free or move internal memory |
|
|
|
and then invalidate pointers to internal strings. |
|
|
|
Lua's garbage collection can free or move memory |
|
|
|
and then invalidate pointers to strings handled by a Lua state. |
|
|
|
To allow a safe use of these pointers, |
|
|
|
the API guarantees that any pointer to a string in a stack index |
|
|
|
is valid while the string value at that index is not removed from the stack. |
|
|
@ -3158,8 +3158,6 @@ The index must be the last index previously marked to be closed |
|
|
|
A @idx{__close} metamethod cannot yield |
|
|
|
when called through this function. |
|
|
|
|
|
|
|
(This function was introduced in @N{release 5.4.3}.) |
|
|
|
|
|
|
|
} |
|
|
|
|
|
|
|
@APIEntry{int lua_closethread (lua_State *L, lua_State *from);| |
|
|
@ -3179,8 +3177,6 @@ The parameter @id{from} represents the coroutine that is resetting @id{L}. |
|
|
|
If there is no such coroutine, |
|
|
|
this parameter can be @id{NULL}. |
|
|
|
|
|
|
|
(This function was introduced in @N{release 5.4.6}.) |
|
|
|
|
|
|
|
} |
|
|
|
|
|
|
|
@APIEntry{int lua_compare (lua_State *L, int index1, int index2, int op);| |
|
|
@ -4227,14 +4223,6 @@ and then pops the top element. |
|
|
|
|
|
|
|
} |
|
|
|
|
|
|
|
@APIEntry{int lua_resetthread (lua_State *L);| |
|
|
|
@apii{0,?,-} |
|
|
|
|
|
|
|
This function is deprecated; |
|
|
|
it is equivalent to @Lid{lua_closethread} with |
|
|
|
@id{from} being @id{NULL}. |
|
|
|
|
|
|
|
} |
|
|
|
|
|
|
|
@APIEntry{int lua_resume (lua_State *L, lua_State *from, int nargs, |
|
|
|
int *nresults);| |
|
|
@ -4516,8 +4504,6 @@ indicates whether the operation succeeded. |
|
|
|
@apii{0,0,m} |
|
|
|
|
|
|
|
Converts the Lua value at the given index to a @N{C string}. |
|
|
|
If @id{len} is not @id{NULL}, |
|
|
|
it sets @T{*len} with the string length. |
|
|
|
The Lua value must be a string or a number; |
|
|
|
otherwise, the function returns @id{NULL}. |
|
|
|
If the value is a number, |
|
|
@ -4526,12 +4512,16 @@ then @id{lua_tolstring} also |
|
|
|
(This change confuses @Lid{lua_next} |
|
|
|
when @id{lua_tolstring} is applied to keys during a table traversal.) |
|
|
|
|
|
|
|
@id{lua_tolstring} returns a pointer |
|
|
|
to a string inside the Lua state @see{constchar}. |
|
|
|
This string always has a zero (@Char{\0}) |
|
|
|
after its last character (as @N{in C}), |
|
|
|
If @id{len} is not @id{NULL}, |
|
|
|
the function sets @T{*len} with the string length. |
|
|
|
The returned @N{C string} always has a zero (@Char{\0}) |
|
|
|
after its last character, |
|
|
|
but can contain other zeros in its body. |
|
|
|
|
|
|
|
The pointer returned by @id{lua_tolstring} |
|
|
|
may be invalidated by the garbage collector if the |
|
|
|
corresponding Lua value is removed from the stack @see{constchar}. |
|
|
|
|
|
|
|
} |
|
|
|
|
|
|
|
@APIEntry{lua_Number lua_tonumber (lua_State *L, int index);| |
|
|
@ -9063,7 +9053,6 @@ The options are: |
|
|
|
@item{@T{--}| stop handling options;} |
|
|
|
@item{@T{-}| execute @id{stdin} as a file and stop handling options.} |
|
|
|
} |
|
|
|
(The form @T{-l @rep{g=mod}} was introduced in @N{release 5.4.4}.) |
|
|
|
|
|
|
|
After handling its options, @id{lua} runs the given @emph{script}. |
|
|
|
When called without arguments, |
|
|
@ -9251,6 +9240,9 @@ declare a local variable with the same name in the loop body. |
|
|
|
@itemize{ |
|
|
|
|
|
|
|
@item{ |
|
|
|
The function @id{lua_resetthread} is deprecated; |
|
|
|
it is equivalent to @Lid{lua_closethread} with |
|
|
|
@id{from} being @id{NULL}. |
|
|
|
} |
|
|
|
|
|
|
|
} |
|
|
|