String.explode - Revision history

NeonBlack: added required function

2009-07-16T17:58:06Z

added required function

← Older revision		Revision as of 17:58, 16 July 2009
Line 17:		Line 17:

	==Code==		==Code==
			{{RequiredFunctions\|Check}}
	<section name="Server- and/or clientside Script" class="both" show="true">		<section name="Server- and/or clientside Script" class="both" show="true">
	<syntaxhighlight lang="lua">		<syntaxhighlight lang="lua">

NeonBlack: updated both name and code

2009-07-16T17:42:54Z

updated both name and code

← Older revision		Revision as of 17:42, 16 July 2009
Line 1:		Line 1:
	{{Useful Function}}		{{Useful Function}}
			<lowercasetitle></lowercasetitle>
	__NOTOC__		__NOTOC__
	This function splits a string at a given separator and stores the pieces in a table. It's the complement of [http://www.lua.org/manual/5.1/manual.html#pdf-table.concat table.concat].		This function splits a string at a given separator (pattern) and stores the pieces in a table. It's the complement of [http://www.lua.org/manual/5.1/manual.html#pdf-table.concat table.concat].

	There is already an MTA function called [[split]] that splits a string at a given separator. But this function only supports single character separators and no regular expressions. For splitting at a single character you should prefer that function since it's probably faster than ~~Explode~~.		There is already an MTA function called [[split]] that splits a string at a given separator. But this function only supports single character separators and no regular expressions. For splitting at a single character you should prefer that function since it's probably faster than string.explode.

	==Syntax==		==Syntax==
	<syntaxhighlight lang="lua">table ~~Explode~~( string ~~separator~~, string ~~ensemble [, bool plain ]~~ )</syntaxhighlight>		<syntaxhighlight lang="lua">table string.explode( string ensemble, string separator )</syntaxhighlight>

	===Required Arguments===		===Required Arguments===
	* '''separator''': The string, which the ensemble shall be split at.
	* '''ensemble''': The string to split.		* '''ensemble''': The string to split.
			* '''separator''': The regular expression pattern, which the ensemble should be split at.
	~~===Optional Arguments===~~
	* '''~~plain~~''': ~~When set to ''true'' the separator is taken as normal string. This is also the default. When set to ''false'' separator is taken as~~ regular expression.

	===Returns===		===Returns===
Line 21:		Line 19:
	<section name="Server- and/or clientside Script" class="both" show="true">		<section name="Server- and/or clientside Script" class="both" show="true">
	<syntaxhighlight lang="lua">		<syntaxhighlight lang="lua">
	function ~~Explode~~(separator~~, ensemble, plain~~)		function string.explode(self, separator)
	if (#separator ~~== 0~~) ~~then return { ensemble } end~~		Check("string.explode", "string", self, "ensemble", "string", separator, "separator")
	if (#~~ensemble~~ == 0) then return {} end
	~~if (plain == nil) then plain = true end~~		if (#self == 0) then return {} end
	~~local position, pieces = 1, {}~~

	~~for s, e in function() return ensemble:find(separator, position) end do~~
	~~table.insert(pieces, ensemble:sub(position, s - 1))~~
	~~position = e + 1~~
	~~end~~
	~~table.insert(pieces, ensemble:sub(position))~~

	~~return pieces~~
	~~end~~
	~~</syntaxhighlight>~~
	~~</section>~~
	~~<section name="Alternative code that includes Explode in the string table" class="both" show="false">~~
	~~'''Note: The arguments are in another order than in Explode!'''<br />~~
	~~(This alternative is still untested! Please test and correct it if needed.)~~
	~~<syntaxhighlight lang="lua">~~
	~~function string:explode(separator, plain)~~
	if (#separator == 0) then return { self } end		if (#separator == 0) then return { self } end
	if (~~#self == 0) then~~ return {~~} end~~
	~~if (plain == nil) then plain = true end~~		return loadstring("return {\""..self:gsub(separator, "\",\"").."\"}")()
	~~local position, pieces = 1, {}~~

	~~for s, e in function() return~~ self:~~find~~(separator, ~~position~~) ~~end do~~
	~~table~~.~~insert(pieces, self:sub(position, s - 1)~~)
	~~position = e + 1~~
	~~end~~
	~~table.insert~~(~~pieces, self:sub(position~~))

	~~return pieces~~
	end		end
	</syntaxhighlight>		</syntaxhighlight>
Line 69:		Line 41:
	local playername = getPlayerNametagText(source)		local playername = getPlayerNametagText(source)
	-- split the player's name to first and last name		-- split the player's name to first and last name
	playername = ~~Explode~~("."~~, playername~~)		playername = playername:explode("%.") -- since . is a wildcard we have to escape it with a %
	-- send a welcome message		-- send a welcome message
	outputChatBox("Welcome on our roleplay server, Mr./Mrs./Ms. "..playername[2]..".", source)		outputChatBox("Welcome on our roleplay server, Mr./Mrs./Ms. "..playername[2]..".", source)

NeonBlack: Explode moved to String.explode: Both Explode's code and name were outdated.

2009-07-16T17:33:04Z

Explode moved to String.explode: Both Explode's code and name were outdated.

← Older revision

Revision as of 17:33, 16 July 2009

Sebassje at 15:59, 2 June 2009

2009-06-02T15:59:15Z

← Older revision		Revision as of 15:59, 2 June 2009
Line 6:		Line 6:

	==Syntax==		==Syntax==
	<syntaxhighlight lang="lua">table Explode( string separator, string ensemble, [ bool plain ] )</syntaxhighlight>		<syntaxhighlight lang="lua">table Explode( string separator, string ensemble [, bool plain ] )</syntaxhighlight>

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

Sebassje at 21:53, 15 May 2009

2009-05-15T21:53:59Z

← Older revision		Revision as of 21:53, 15 May 2009
Line 79:		Line 79:

	Author: NeonBlack		Author: NeonBlack

			==See Also==
			{{Useful_Functions}}

Awwu at 13:04, 14 May 2009

2009-05-14T13:04:13Z

← Older revision		Revision as of 13:04, 14 May 2009
Line 79:		Line 79:

	Author: NeonBlack		Author: NeonBlack

	~~[[Category:Useful Functions]]~~

NeonBlack: added alternative code

2009-05-14T10:46:47Z

added alternative code

@@ Line 32: / Line 32: @@
      end
      table.insert(pieces, ensemble:sub(position))
      return pieces

NeonBlack: added useful function header

2009-05-13T22:22:34Z

added useful function header

← Older revision		Revision as of 22:22, 13 May 2009
Line 1:		Line 1:
			{{Useful Function}}
	__NOTOC__		__NOTOC__
	This function splits a string at a given separator and stores the pieces in a table. It's the complement of [http://www.lua.org/manual/5.1/manual.html#pdf-table.concat table.concat].		This function splits a string at a given separator and stores the pieces in a table. It's the complement of [http://www.lua.org/manual/5.1/manual.html#pdf-table.concat table.concat].

NeonBlack at 15:26, 13 May 2009

2009-05-13T15:26:53Z

← Older revision		Revision as of 15:26, 13 May 2009
Line 2:		Line 2:
	This function splits a string at a given separator and stores the pieces in a table. It's the complement of [http://www.lua.org/manual/5.1/manual.html#pdf-table.concat table.concat].		This function splits a string at a given separator and stores the pieces in a table. It's the complement of [http://www.lua.org/manual/5.1/manual.html#pdf-table.concat table.concat].

	There is already a MTA function called [[split]] that splits a string at a given separator. But this function only supports single character separators and no regular expressions. For splitting at a single character you should prefer that function since it's probably faster than Explode.		There is already an MTA function called [[split]] that splits a string at a given separator. But this function only supports single character separators and no regular expressions. For splitting at a single character you should prefer that function since it's probably faster than Explode.

	==Syntax==		==Syntax==

NeonBlack: added note that there's a function named split

2009-05-13T15:26:10Z

added note that there's a function named split

← Older revision		Revision as of 15:26, 13 May 2009
Line 1:		Line 1:
	__NOTOC__		__NOTOC__
	This function splits a string at a given separator and stores the pieces in a table. It's the complement of [http://www.lua.org/manual/5.1/manual.html#pdf-table.concat table.concat].		This function splits a string at a given separator and stores the pieces in a table. It's the complement of [http://www.lua.org/manual/5.1/manual.html#pdf-table.concat table.concat].

			There is already a MTA function called [[split]] that splits a string at a given separator. But this function only supports single character separators and no regular expressions. For splitting at a single character you should prefer that function since it's probably faster than Explode.

	==Syntax==		==Syntax==