Split - Revision history

Arran Fortuna: Added splitMultiple info to split

2023-11-15T16:59:40Z

Added splitMultiple info to split

← Older revision		Revision as of 16:59, 15 November 2023
Line 10:		Line 10:
	===Required Arguments===		===Required Arguments===
	* '''stringToSplit''' The string you wish to split into parts.		* '''stringToSplit''' The string you wish to split into parts.
	* '''separatingChar''' A string of the character you want to split, or the [[ASCII\|ASCII number]] representing the character you want to use to split.		* '''separatingChar''' A string of the character you want to split, or the [[ASCII\|ASCII number]] representing the character you want to use to split. If you want to split a string at multiple characters see [[splitMultiple]]

	===Returns===		===Returns===
Line 21:		Line 21:
	{{note\|You can't use same char twice as a separator. Eg.: \|\|, \|\|\| are the same as \|.		{{note\|You can't use same char twice as a separator. Eg.: \|\|, \|\|\| are the same as \|.
	}}		}}


	==Example==		==Example==

2020-06-28T08:59:23Z

← Older revision		Revision as of 08:59, 28 June 2020
Line 19:		Line 19:


	{{note\|You can't use same char twice as a separator. Eg.: "\|\|", "\|\|\|~~" is~~ the same as "\|".		{{note\|You can't use same char twice as a separator. Eg.: \|\|, \|\|\| are the same as \|.
	}}		}}

2020-06-28T08:58:37Z

← Older revision		Revision as of 08:58, 28 June 2020
Line 4:		Line 4:

	'''Note:''' You can use the function [[gettok]] to retrieve a single token from the string at a specific index. This may be faster for one-off lookups, but considerably slower if you are going to check each token in a long string.		'''Note:''' You can use the function [[gettok]] to retrieve a single token from the string at a specific index. This may be faster for one-off lookups, but considerably slower if you are going to check each token in a long string.

	~~'''Note:''' You can't use same char twice as a separator. Eg.: "\|\|", "\|\|\|" is the same as "\|"~~

	==Syntax==		==Syntax==
Line 19:		Line 17:
	{{note\|Unicode characters work but when combined with others do not. E.g: #split("a€cb†", "€") returns 3 but #split("a€cb", "€") returns 2.		{{note\|Unicode characters work but when combined with others do not. E.g: #split("a€cb†", "€") returns 3 but #split("a€cb", "€") returns 2.
	}}		}}


			{{note\|You can't use same char twice as a separator. Eg.: "\|\|", "\|\|\|" is the same as "\|".
			}}


	==Example==		==Example==

2020-06-28T08:58:09Z

Add note that same chars can't be used twice

← Older revision		Revision as of 08:58, 28 June 2020
Line 4:		Line 4:

	'''Note:''' You can use the function [[gettok]] to retrieve a single token from the string at a specific index. This may be faster for one-off lookups, but considerably slower if you are going to check each token in a long string.		'''Note:''' You can use the function [[gettok]] to retrieve a single token from the string at a specific index. This may be faster for one-off lookups, but considerably slower if you are going to check each token in a long string.

			'''Note:''' You can't use same char twice as a separator. Eg.: "\|\|", "\|\|\|" is the same as "\|"

	==Syntax==		==Syntax==

2020-06-28T08:53:41Z

change string.byte(",") to ","

← Older revision		Revision as of 08:53, 28 June 2020
Line 26:		Line 26:
	for k,v in ipairs(weaponsTable) do --for all the split values do		for k,v in ipairs(weaponsTable) do --for all the split values do
	weaponId = gettok(v, 1, string.byte(',')) --get the weapon ID using gettok, retrieve the first token		weaponId = gettok(v, 1, string.byte(',')) --get the weapon ID using gettok, retrieve the first token
	weaponAmmo = gettok(v, 2, ~~string.byte('~~,')) --get the ammo using gettok, retrieve the second token		weaponAmmo = gettok(v, 2, ",") --get the ammo using gettok, retrieve the second token
	if (weaponId ~~~= nil~~ and weaponAmmo ~~~= nil~~) then --if neither of them is invalid		if (weaponId and weaponAmmo) then --if neither of them is invalid
	giveWeapon(player, weaponId, weaponAmmo) --give the player the weapons		giveWeapon(player, weaponId, weaponAmmo) --give the player the weapons
	end		end

2013-12-09T16:17:30Z

← Older revision		Revision as of 16:17, 9 December 2013
Line 15:		Line 15:
	Returns a ''table'' of substrings split from the original string if successful, ''false'' otherwise.		Returns a ''table'' of substrings split from the original string if successful, ''false'' otherwise.

	{{note\|~~Extended ASCII~~ characters work but when combined with others do not. E.g: #split("a€cb†", "€") returns 4 but #split("a€cb", "€") returns 3.		{{note\|Unicode characters work but when combined with others do not. E.g: #split("a€cb†", "€") returns 3 but #split("a€cb", "€") returns 2.
	}}		}}

2013-12-08T20:36:19Z

← Older revision		Revision as of 20:36, 8 December 2013
Line 15:		Line 15:
	Returns a ''table'' of substrings split from the original string if successful, ''false'' otherwise.		Returns a ''table'' of substrings split from the original string if successful, ''false'' otherwise.

	{{note\|~~Certain~~ characters ~~don't behave correctly~~ with split: "¦" ~~and~~ "¬"}}		{{note\|Extended ASCII characters work but when combined with others do not. E.g: #split("a€cb†", "€") returns 4 but #split("a€cb", "€") returns 3.
			}}

	==Example==		==Example==

2013-12-08T20:22:29Z

← Older revision		Revision as of 20:22, 8 December 2013
Line 14:		Line 14:
	===Returns===		===Returns===
	Returns a ''table'' of substrings split from the original string if successful, ''false'' otherwise.		Returns a ''table'' of substrings split from the original string if successful, ''false'' otherwise.

			{{note\|Certain characters don't behave correctly with split: "¦" and "¬"}}

	==Example==		==Example==

2012-02-05T14:00:36Z

← Older revision		Revision as of 14:00, 5 February 2012
Line 10:		Line 10:
	===Required Arguments===		===Required Arguments===
	* '''stringToSplit''' The string you wish to split into parts.		* '''stringToSplit''' The string you wish to split into parts.
	* '''separatingChar''' ~~The~~ [[ASCII\|ASCII number]] representing the character you want to use to split~~. You can easily retrieve this by running string.byte on a string containing the separating character~~.		* '''separatingChar''' A string of the character you want to split, or the [[ASCII\|ASCII number]] representing the character you want to use to split.

	===Returns===		===Returns===
Line 20:		Line 20:
	<syntaxhighlight lang="lua">		<syntaxhighlight lang="lua">
	function giveWeapons(player, weaponsString)		function giveWeapons(player, weaponsString)
	local weaponsTable = split(weaponsString, ~~string.byte(~~';')) --split the string by the semi colon		local weaponsTable = split(weaponsString, ';') --split the string by the semi colon
	for k,v in ipairs(weaponsTable) do --for all the split values do		for k,v in ipairs(weaponsTable) do --for all the split values do
	weaponId = gettok(v, 1, string.byte(',')) --get the weapon ID using gettok, retrieve the first token		weaponId = gettok(v, 1, string.byte(',')) --get the weapon ID using gettok, retrieve the first token

2011-09-13T11:49:01Z

← Older revision		Revision as of 11:49, 13 September 2011
Line 6:		Line 6:

	==Syntax==		==Syntax==
	~~<syntaxhighlight lang="lua">table split ( string stringToSplit, int separatingChar )</syntaxhighlight>~~
	~~{{New feature\|3.0110\|1.1\|~~
	<syntaxhighlight lang="lua">table split ( string stringToSplit, string / int separatingChar )</syntaxhighlight>		<syntaxhighlight lang="lua">table split ( string stringToSplit, string / int separatingChar )</syntaxhighlight>
	}}

	===Required Arguments===		===Required Arguments===