FromJSON - Revision history

Tails: minor fixes

2026-06-10T15:50:47Z

minor fixes

← Older revision		Revision as of 15:50, 10 June 2026
Line 21:		Line 21:

	===Returns===		===Returns===
	Returns the ~~parse~~ JSON data as multiple values or a single table depending on the input JSON structure:		Returns the parsed JSON data as multiple values or a single table depending on the input JSON structure:
	* Returns '''multiple separate values''' (unpacked) if the root element of the JSON is an array		* Returns '''multiple separate values''' (unpacked) if the root element of the JSON is an '''array'''
	* Returns a ~~single~~ table if the root element of the JSON is an object		* Returns a '''table''' if the root element of the JSON is an '''object'''
	* Returns [[nil]] if the JSON string is invalid or malformed.		* Returns [[nil]] if the JSON string is invalid or malformed.

Line 41:		Line 41:
	This example shows how to capture all values of a JSON array in a single Lua table.		This example shows how to capture all values of a JSON array in a single Lua table.
	<syntaxhighlight lang="lua">		<syntaxhighlight lang="lua">
	local jsonArray = '["Apple", "Orange"]'		local jsonArray = '["Apple", "Orange", "Banana"]'

	-- Put the fromJSON call inside of a table directly to capture all the values of the JSON array		-- Put the fromJSON call inside of a table directly to capture all the values of the JSON array
	local fruits = {fromJSON(jsonArray)}		local fruits = {fromJSON(jsonArray)}

	~~print(~~fruits[1], fruits[2]) --> Output: Apple Orange		if fruits[1] then -- Make sure the JSON was parsed correctly
			for i=1, #fruits do
			print(fruits[i])
			end
			--[[ Output:
			Apple
			Orange
			Banana
			]]
			end

	</syntaxhighlight>		</syntaxhighlight>

Tails at 02:12, 9 June 2026

2026-06-09T02:12:30Z

← Older revision		Revision as of 02:12, 9 June 2026
Line 3:		Line 3:
	This function parses a [[JSON]] formatted string and unpacks the values into Lua variables. You can use [[toJSON]] to encode variables into a JSON string that can be read by this function.		This function parses a [[JSON]] formatted string and unpacks the values into Lua variables. You can use [[toJSON]] to encode variables into a JSON string that can be read by this function.

	{{Important Note\|1=When parsing a JSON array, [[fromJSON]] ~~returns~~ the elements as multiple separate values ~~(unpacked)~~. To mimic standard JSON ~~decoders~~ and store these elements together in a single Lua table, you must wrap the function call in a table constructor {}.		{{Important Note\|1=When parsing a JSON array, [[fromJSON]] unpacks the elements as multiple separate values. To mimic standard JSON parsing behavior and store these elements together in a single Lua table, you must wrap the function call in a table constructor {}.
	If your JSON string was generated directly by [[toJSON]], you do not need to wrap it!		If your JSON string was generated directly by [[toJSON]], you do not need to wrap it.
	<syntaxhighlight lang="lua">		<syntaxhighlight lang="lua">
	local jsonString = '["Apple", "Orange"]'		local jsonString = '["Apple", "Orange"]'
Line 22:		Line 22:
	===Returns===		===Returns===
	Returns the parse JSON data as multiple values or a single table depending on the input JSON structure:		Returns the parse JSON data as multiple values or a single table depending on the input JSON structure:
	* Returns '''multiple separate values''' (~~destructured~~) if the root element of the JSON is an array		* Returns '''multiple separate values''' (unpacked) if the root element of the JSON is an array
	* Returns a single table if the root element of the JSON is an object		* Returns a single table if the root element of the JSON is an object
	* Returns [[nil]] if the JSON string is invalid or malformed.		* Returns [[nil]] if the JSON string is invalid or malformed.

Tails: Added important note & better examples - lots of people have had headaches due to how fromJSON unpacks JSON array values into multiple values

2026-06-09T02:08:30Z

Added important note & better examples - lots of people have had headaches due to how fromJSON unpacks JSON array values into multiple values

← Older revision		Revision as of 02:08, 9 June 2026
Line 1:		Line 1:
	__NOTOC__		__NOTOC__
	{{Server client function}}		{{Server client function}}
	This function parses a [[JSON]] formatted string into variables. You can use [[toJSON]] to encode variables into a JSON string that can be read by this function.		This function parses a [[JSON]] formatted string and unpacks the values into Lua variables. You can use [[toJSON]] to encode variables into a JSON string that can be read by this function.

			{{Important Note\|1=When parsing a JSON array, [[fromJSON]] returns the elements as multiple separate values (unpacked). To mimic standard JSON decoders and store these elements together in a single Lua table, you must wrap the function call in a table constructor {}.
			If your JSON string was generated directly by [[toJSON]], you do not need to wrap it!
			<syntaxhighlight lang="lua">
			local jsonString = '["Apple", "Orange"]'
			local fruitsTable = { fromJSON(jsonString) }
			</syntaxhighlight>

			}}

	==Syntax==		==Syntax==
	<syntaxhighlight lang="lua">		<syntaxhighlight lang="lua">
	var fromJSON ( string json )		var... fromJSON ( string json )
	</syntaxhighlight>		</syntaxhighlight>

	===Required Arguments===		===Required Arguments===
	*'''json:''' A JSON formatted string		*'''json:''' A JSON formatted string.

	===Returns===		===Returns===
	Returns variables ~~read~~ from ~~the~~ JSON ~~string~~.		Returns the parse JSON data as multiple values or a single table depending on the input JSON structure:
			* Returns '''multiple separate values''' (destructured) if the root element of the JSON is an array
			* Returns a single table if the root element of the JSON is an object
			* Returns [[nil]] if the JSON string is invalid or malformed.

			==Examples==

			===Example 1: Assigning to multiple variables===
			This example shows how fromJSON extracts values from a JSON array directly into separate Lua variables.
			<syntaxhighlight lang="lua">
			local jsonArray = '["Desert Eagle", 24]'

			local name, ammo = fromJSON(jsonArray)

			print(name, ammo) --> Output: Desert Eagle 24
			</syntaxhighlight>

	~~'''Note~~:~~''' Indices~~ of a JSON ~~object such as~~ "1": "~~cat~~" ~~are being returned as~~ [~~[string]~~], ~~not as~~ [~~[int~~]~~]eger.~~		===Example 2: Wrapping the call inside a table===
			This example shows how to capture all values of a JSON array in a single Lua table.
			<syntaxhighlight lang="lua">
			local jsonArray = '["Apple", "Orange"]'

			-- Put the fromJSON call inside of a table directly to capture all the values of the JSON array
			local fruits = {fromJSON(jsonArray)}

			print(fruits[1], fruits[2]) --> Output: Apple Orange
			</syntaxhighlight>

	==~~Examples~~==		===Example 3: Parsing a JSON object===
	~~This makes data equal~~: ~~''{ ["1"] = "cat", ["2"] = "mouse", ["3"] = 5, ["4"]~~ = ~~null, ["cat"]~~ = ~~5, ["mouse"]~~ =~~1 }''~~
	<syntaxhighlight lang="lua">		<syntaxhighlight lang="lua">
	local ~~data~~ = ~~fromJSON (~~ '[ { "~~1": "cat", "2~~": "~~mouse~~", "3": ~~5, "4": null, "cat":5, "mouse":1~~ } ]' )		local jsonObject = '{"playerName": "Alex", "score": 2500}'

			local playerStats = fromJSON(jsonObject)

			if playerStats then
			print(playerStats.playerName) --> Output: Alex
			print(playerStats.score) --> Output: 2500
			end
	</syntaxhighlight>		</syntaxhighlight>

	~~This shows how to extract data from~~ JSON:		===Example 4: Parsing a nested JSON object===
	<syntaxhighlight lang="lua">		<syntaxhighlight lang="lua">
	local ~~name, weapon, ammo~~ = ~~fromJSON(~~"[\"~~Desert Eagle\~~", 24, ~~147]~~")		local jsonString = '{"vehicle": "Infernus", "upgrades": {"nos": true, "paintjob": 2}}'

			local vehicleInfo = fromJSON(jsonString)

			if vehicleInfo then
			print(vehicleInfo.vehicle) --> Output: Infernus
			print(vehicleInfo.upgrades.nos) --> Output: true
			print(vehicleInfo.upgrades.paintjob) --> Output: 2
			end
	</syntaxhighlight>		</syntaxhighlight>

	==See Also==		==See Also==
	{{Server_functions}}		{{Server_functions}}

Fernando187: /* Examples */

2025-06-08T13:36:50Z

Examples

← Older revision		Revision as of 13:36, 8 June 2025
Line 22:		Line 22:
	</syntaxhighlight>		</syntaxhighlight>

			This shows how to extract data from JSON:
	<syntaxhighlight lang="lua">		<syntaxhighlight lang="lua">
	local name, weapon, ammo = fromJSON("[\"Desert Eagle\", 24, 147]")		local name, weapon, ammo = fromJSON("[\"Desert Eagle\", 24, 147]")

Fernando187: Fix examples header

2025-06-08T13:36:14Z

Fix examples header

← Older revision		Revision as of 13:36, 8 June 2025
Line 16:		Line 16:
	'''Note:''' Indices of a JSON object such as "1": "cat" are being returned as [[string]], not as [[int]]eger.		'''Note:''' Indices of a JSON object such as "1": "cat" are being returned as [[string]], not as [[int]]eger.

	==~~Example~~==		==Examples==
	This makes data equal: ''{ ["1"] = "cat", ["2"] = "mouse", ["3"] = 5, ["4"] = null, ["cat"] = 5, ["mouse"] =1 }''		This makes data equal: ''{ ["1"] = "cat", ["2"] = "mouse", ["3"] = 5, ["4"] = null, ["cat"] = 5, ["mouse"] =1 }''
	<syntaxhighlight lang="lua">		<syntaxhighlight lang="lua">
Line 22:		Line 22:
	</syntaxhighlight>		</syntaxhighlight>

	~~==Example 2==~~
	<syntaxhighlight lang="lua">		<syntaxhighlight lang="lua">
	local name, weapon, ammo = fromJSON("[\"Desert Eagle\", 24, 147]")		local name, weapon, ammo = fromJSON("[\"Desert Eagle\", 24, 147]")

Fernando187: Remove obsolete Requirements section

2024-11-07T15:32:25Z

Remove obsolete Requirements section

← Older revision		Revision as of 15:32, 7 November 2024
Line 26:		Line 26:
	local name, weapon, ammo = fromJSON("[\"Desert Eagle\", 24, 147]")		local name, weapon, ammo = fromJSON("[\"Desert Eagle\", 24, 147]")
	</syntaxhighlight>		</syntaxhighlight>

	~~==Requirements==~~
	~~{{Requirements\|1.0\|1.1.1-9.03316\|}}~~

	==See Also==		==See Also==
	{{Server_functions}}		{{Server_functions}}

Arran Fortuna at 09:33, 29 September 2019

2019-09-29T09:33:24Z

← Older revision		Revision as of 09:33, 29 September 2019
Line 1:		Line 1:
	__NOTOC__		__NOTOC__
	{{Server client function}}		{{Server client function}}
	~~{{New feature/item\|3.0140\|1.2\|\|~~
	~~This function is available client-side in 1.2 and onwards.~~
	}}

	This function parses a [[JSON]] formatted string into variables. You can use [[toJSON]] to encode variables into a JSON string that can be read by this function.		This function parses a [[JSON]] formatted string into variables. You can use [[toJSON]] to encode variables into a JSON string that can be read by this function.

Einheit-101: The bug that existed in MTA 1.3.6 is no longer relevant so i removed that warning message.

2017-07-01T01:08:13Z

The bug that existed in MTA 1.3.6 is no longer relevant so i removed that warning message.

@@ Line 3: / Line 3: @@
 {{New feature/item|3.0140|1.2||
 This function is available client-side in 1.2 and onwards.
 }}

AlexTMjugador: Undo revision 43303 by Glossy (talk)

2014-12-16T14:50:33Z

Undo revision 43303 by Glossy (talk)

← Older revision		Revision as of 14:50, 16 December 2014
Line 42:		Line 42:

	==Requirements==		==Requirements==
	{{Requirements\|1.4\|1.1.1-9.03316\|}}		{{Requirements\|1.0\|1.1.1-9.03316\|}}

	==See Also==		==See Also==
	{{Server_functions}}		{{Server_functions}}

Glossy: /* Requirements */

2014-12-16T11:36:13Z

Requirements

← Older revision		Revision as of 11:36, 16 December 2014
Line 42:		Line 42:

	==Requirements==		==Requirements==
	{{Requirements\|1.0\|1.1.1-9.03316\|}}		{{Requirements\|1.4\|1.1.1-9.03316\|}}

	==See Also==		==See Also==
	{{Server_functions}}		{{Server_functions}}