JLuaVM - Revision history

GHXX: /* Additional standard library functions */

2026-08-25T16:33:34Z

Additional standard library functions

← Older revision		Revision as of 16:33, 25 August 2026
Line 94:		Line 94:
	\|<code>"preempted"</code>		\|<code>"preempted"</code>
	\|The coroutine has exceeded the execution <code>timeout</code> (given in seconds) and has been forcefully paused. In this event <code>coroutine.status(co)</code> will return <code>"preempted_resumable"</code>. Any child coroutines that were currently running at the time of yielding will enter the state <code>"preempted_blocked"</code>. Attempting to <code>resume()</code> such <code>preempted_blocked</code> coroutines will throw an error.		\|The coroutine has exceeded the execution <code>timeout</code> (given in seconds) and has been forcefully paused. In this event <code>coroutine.status(co)</code> will return <code>"preempted_resumable"</code>. Any child coroutines that were currently running at the time of yielding will enter the state <code>"preempted_blocked"</code>. Attempting to <code>resume()</code> such <code>preempted_blocked</code> coroutines will throw an error.
			This is intended as a last-resort mechanism for task schedulers to interrupt uncooperative processes.
	\|-		\|-
	\|<code>coroutine.status(co:thread)</code>		\|<code>coroutine.status(co:thread)</code>

GHXX: /* Additional standard library functions */

2026-08-25T15:21:53Z

Additional standard library functions

← Older revision		Revision as of 15:21, 25 August 2026
Line 75:		Line 75:

	== Additional standard library functions ==		== Additional standard library functions ==
			This is a list of all additional callable, non-standard functions provided by JLuaVM.
	{\| class="wikitable"		{\| class="wikitable"
	!Function		!Function

GHXX: /* Additional standard library functions */

2026-08-25T15:20:25Z

Additional standard library functions

← Older revision		Revision as of 15:20, 25 August 2026
Line 93:		Line 93:
	\|<code>"preempted"</code>		\|<code>"preempted"</code>
	\|The coroutine has exceeded the execution <code>timeout</code> (given in seconds) and has been forcefully paused. In this event <code>coroutine.status(co)</code> will return <code>"preempted_resumable"</code>. Any child coroutines that were currently running at the time of yielding will enter the state <code>"preempted_blocked"</code>. Attempting to <code>resume()</code> such <code>preempted_blocked</code> coroutines will throw an error.		\|The coroutine has exceeded the execution <code>timeout</code> (given in seconds) and has been forcefully paused. In this event <code>coroutine.status(co)</code> will return <code>"preempted_resumable"</code>. Any child coroutines that were currently running at the time of yielding will enter the state <code>"preempted_blocked"</code>. Attempting to <code>resume()</code> such <code>preempted_blocked</code> coroutines will throw an error.
			\|-
			\|<code>coroutine.status(co:thread)</code>
			\|<code>string</code>
			\|For completeness, this function may return all of the LuaC states <code>suspended</code>, <code>running</code>, <code>normal</code> and <code>dead</code> as well as <code>preempted_resumable</code> and <code>preempted_blocked</code>.
			Resumable states are <code>suspended</code> and <code>preempted_resumable</code>.
	\|}		\|}
	Further functionality that is NOT available in [[Advanced Computers]].		Further functionality that is NOT available in [[Advanced Computers]].

GHXX: /* Additional standard library functions */

2026-08-25T15:17:32Z

Additional standard library functions

← Older revision		Revision as of 15:17, 25 August 2026
Line 92:		Line 92:
	\|-		\|-
	\|<code>"preempted"</code>		\|<code>"preempted"</code>
	\|The coroutine has exceeded the execution timeout and has been forcefully paused. In this event <code>coroutine.status(co)</code> will return <code>"preempted_resumable"</code>. Any child coroutines that were currently running at the time of yielding will enter the state <code>"preempted_blocked"</code>. Attempting to <code>resume()</code> such <code>preempted_blocked</code> coroutines will throw an error.		\|The coroutine has exceeded the execution <code>timeout</code> (given in seconds) and has been forcefully paused. In this event <code>coroutine.status(co)</code> will return <code>"preempted_resumable"</code>. Any child coroutines that were currently running at the time of yielding will enter the state <code>"preempted_blocked"</code>. Attempting to <code>resume()</code> such <code>preempted_blocked</code> coroutines will throw an error.
	\|}		\|}
	Further functionality that is NOT available in [[Advanced Computers]].		Further functionality that is NOT available in [[Advanced Computers]].

GHXX: /* Additional standard library functions */

2026-08-25T15:16:20Z

Additional standard library functions

← Older revision		Revision as of 15:16, 25 August 2026
Line 84:		Line 84:
	\|Returns a table whose keys are all values that are readable or writable in the given userdata object <code>obj</code>. The value of each key is either <code>r</code>, <code>w</code> or <code>rw</code>, depending on whether the key is readable writable or readwrite.		\|Returns a table whose keys are all values that are readable or writable in the given userdata object <code>obj</code>. The value of each key is either <code>r</code>, <code>w</code> or <code>rw</code>, depending on whether the key is readable writable or readwrite.
	\|-		\|-
	\|<code>coroutine.resumeWithTimeout(co:thread, timeout:number, ...)</code>		\| rowspan="3" \|<code>coroutine.resumeWithTimeout(co:thread, timeout:number, ...)</code>
	\| ~~colspan="2"~~ style="padding:0;"\|		\| style="padding:0;" \|<code>true, ...</code>
	~~{\| class="wikitable" style="margin:0;"~~
	~~!Returns~~
	~~!Description~~
	\|-
	\|<code>true, ...</code>
	\|The coroutine has yielded on its own. Any arguments supplied to <code>coroutine.yield(...)</code>, are returned after <code>true</code>.		\|The coroutine has yielded on its own. Any arguments supplied to <code>coroutine.yield(...)</code>, are returned after <code>true</code>.
	\|-		\|-
	\|<code>false, any:errorMessage</code>		\|<code>false, any:errorMessage</code>
	\|The coroutine has errored.		\|The coroutine has errored.
	\|-		\|-
	\|<code>"preempted"</code>		\|<code>"preempted"</code>
	\|The coroutine has exceeded the execution timeout and has been forcefully paused. In this event <code>coroutine.status(co)</code> will return <code>"preempted_resumable"</code>. Any child coroutines that were currently running at the time of yielding will enter the state <code>"preempted_blocked"</code>. Attempting to <code>resume()</code> such <code>preempted_blocked</code> coroutines will throw an error.		\|The coroutine has exceeded the execution timeout and has been forcefully paused. In this event <code>coroutine.status(co)</code> will return <code>"preempted_resumable"</code>. Any child coroutines that were currently running at the time of yielding will enter the state <code>"preempted_blocked"</code>. Attempting to <code>resume()</code> such <code>preempted_blocked</code> coroutines will throw an error.
	\|}
	\|}		\|}
	Further functionality that is NOT available in [[Advanced Computers]].		Further functionality that is NOT available in [[Advanced Computers]].

GHXX at 15:15, 25 August 2026

2026-08-25T15:15:27Z

← Older revision		Revision as of 15:15, 25 August 2026
Line 85:		Line 85:
	\|-		\|-
	\|<code>coroutine.resumeWithTimeout(co:thread, timeout:number, ...)</code>		\|<code>coroutine.resumeWithTimeout(co:thread, timeout:number, ...)</code>
	\| colspan="2" \|		\| colspan="2" style="padding:0;"\|
	{\| class="wikitable" style="margin:0;"		{\| class="wikitable" style="margin:0;"
	!Returns		!Returns
Line 101:		Line 101:
	\|}		\|}
	Further functionality that is NOT available in [[Advanced Computers]].		Further functionality that is NOT available in [[Advanced Computers]].
	{\| class="wikitable"		{\| class="wikitable"
	!Function		!Function
	!Returns		!Returns

GHXX at 15:11, 25 August 2026

2026-08-25T15:11:39Z

← Older revision		Revision as of 15:11, 25 August 2026
Line 73:		Line 73:

	In more general terms we access <code>_ENV["_EXT][NAME OF TYPE][NAME OF FUNCTION]</code> (where <code>_ENV</code> is often equivalent to <code>_G</code>). If no match is found, we simply raise the usual error.		In more general terms we access <code>_ENV["_EXT][NAME OF TYPE][NAME OF FUNCTION]</code> (where <code>_ENV</code> is often equivalent to <code>_G</code>). If no match is found, we simply raise the usual error.

			== Additional standard library functions ==
			{\| class="wikitable"
			!Function
			!Returns
			!Description
			\|-
			\|<code>vm.listUdKeys(obj:userdata)</code>
			\|<code>table</code>
			\|Returns a table whose keys are all values that are readable or writable in the given userdata object <code>obj</code>. The value of each key is either <code>r</code>, <code>w</code> or <code>rw</code>, depending on whether the key is readable writable or readwrite.
			\|-
			\|<code>coroutine.resumeWithTimeout(co:thread, timeout:number, ...)</code>
			\| colspan="2" \|
			{\| class="wikitable" style="margin:0;"
			!Returns
			!Description
			\|-
			\|<code>true, ...</code>
			\|The coroutine has yielded on its own. Any arguments supplied to <code>coroutine.yield(...)</code>, are returned after <code>true</code>.
			\|-
			\|<code>false, any:errorMessage</code>
			\|The coroutine has errored.
			\|-
			\|<code>"preempted"</code>
			\|The coroutine has exceeded the execution timeout and has been forcefully paused. In this event <code>coroutine.status(co)</code> will return <code>"preempted_resumable"</code>. Any child coroutines that were currently running at the time of yielding will enter the state <code>"preempted_blocked"</code>. Attempting to <code>resume()</code> such <code>preempted_blocked</code> coroutines will throw an error.
			\|}
			\|}
			Further functionality that is NOT available in [[Advanced Computers]].
			{\| class="wikitable"
			!Function
			!Returns
			!Description
			\|-
			\|<code>vm.pause()</code>
			\|<code>void</code>
			\|Immediately pauses the current LuaVM.
			\|}

	{{Navbox content}}		{{Navbox content}}

GHXX at 12:41, 22 August 2026

2026-08-22T12:41:57Z

← Older revision		Revision as of 12:41, 22 August 2026
Line 73:		Line 73:

	In more general terms we access <code>_ENV["_EXT][NAME OF TYPE][NAME OF FUNCTION]</code> (where <code>_ENV</code> is often equivalent to <code>_G</code>). If no match is found, we simply raise the usual error.		In more general terms we access <code>_ENV["_EXT][NAME OF TYPE][NAME OF FUNCTION]</code> (where <code>_ENV</code> is often equivalent to <code>_G</code>). If no match is found, we simply raise the usual error.

			{{Navbox content}}

GHXX at 12:41, 22 August 2026

2026-08-22T12:41:39Z

← Older revision		Revision as of 12:41, 22 August 2026
Line 2:		Line 2:

	While we try to keep things very similar, there are a few tiny differences, listed below. In the remainder of this article, LuaC refers to PUC-Rio's implementation of Lua. If you spot a difference between JLuaVM and LuaC which is not listed here, please open a ticket at https://github.com/MidnightMages/JLuaVM/issues with a snippet that functions differently between JLuaVM and LuaC.		While we try to keep things very similar, there are a few tiny differences, listed below. In the remainder of this article, LuaC refers to PUC-Rio's implementation of Lua. If you spot a difference between JLuaVM and LuaC which is not listed here, please open a ticket at https://github.com/MidnightMages/JLuaVM/issues with a snippet that functions differently between JLuaVM and LuaC.

			If you would like to contribute please see https://github.com/MidnightMages/JLuaVM/tree/master#contributing.

	== LuaC deviations ==		== LuaC deviations ==

GHXX at 12:37, 22 August 2026

2026-08-22T12:37:46Z

← Older revision		Revision as of 12:37, 22 August 2026
Line 1:		Line 1:
	The JLuaVM, is the runtime that executes the Lua code that is running on computers in [[Advanced Computers]]. The source can be found [https://github.com/MidnightMages/JLuaVM on GitHub]. While we try to keep things very similar, there are a few tiny differences, listed below. In the remainder of this article, LuaC refers to PUC-Rio's implementation of Lua.		The JLuaVM, is the runtime that executes the Lua code that is running on computers in [[Advanced Computers]]. The source can be found [https://github.com/MidnightMages/JLuaVM on GitHub]. The most important feature for Advanced Computers is the ability to save and restore the Lua execution state, regardless of what Lua code may be loaded. We are not aware of any Java based Lua runtime being capable of this, hence why this project was born in the first place.

			While we try to keep things very similar, there are a few tiny differences, listed below. In the remainder of this article, LuaC refers to PUC-Rio's implementation of Lua. If you spot a difference between JLuaVM and LuaC which is not listed here, please open a ticket at https://github.com/MidnightMages/JLuaVM/issues with a snippet that functions differently between JLuaVM and LuaC.

	== LuaC deviations ==		== LuaC deviations ==