WoW:API gsub - Revision history

Move page script: Move page script moved page API gsub to WoW:API gsub without leaving a redirect

2023-08-15T04:46:36Z

Move page script moved page API gsub to API gsub without leaving a redirect

← Older revision	Revision as of 04:46, 15 August 2023
(No difference)

Bear at 07:05, 12 May 2020

2020-05-12T07:05:16Z

← Older revision		Revision as of 07:05, 12 May 2020
Line 20:		Line 20:
	bnanaa 2		bnanaa 2

	If the replacement is a function, not a string, the arguments passed to the function are any captures that are made. If the function returns a string, the value returned is substituted back into the string. Just like string.find() we can use regular expressions to search in strings. Patterns are covered in the [http://lua-users.org/wiki/PatternsTutorial Patterns Tutorial on Lua-Users.org], and [[~~HOWTO: Use Pattern Matching~~]].		If the replacement is a function, not a string, the arguments passed to the function are any captures that are made. If the function returns a string, the value returned is substituted back into the string. Just like string.find() we can use regular expressions to search in strings. Patterns are covered in the [http://lua-users.org/wiki/PatternsTutorial Patterns Tutorial on Lua-Users.org], and the [[pattern matching]] HOWTO.

	> = string.gsub("Hello Lua user", "(%w+)", print) -- print any words found		> = string.gsub("Hello Lua user", "(%w+)", print) -- print any words found

WoWWiki>Starlightblunder: + strreplace

2010-03-25T23:25:38Z

+ strreplace

← Older revision		Revision as of 23:25, 25 March 2010
Line 1:		Line 1:
	{{~~:Lua/Libshortcut\|gsub\|string.gsub~~}}		{{luaapi}}
	string.gsub(s, pattern, replace [, n])		string.gsub(s, pattern, replace [, n])
			gsub(s, pattern, replace [, n])
			strreplace(s, pattern, replace [, n])

	This is a very powerful function and can be used in multiple ways. Used simply it can replace all instances of the pattern provided with the replacement. A pair of values is returned, the modified string and the number of substitutions made. The optional fourth argument n can be used to limit the number of substitutions made:		This is a very powerful function and can be used in multiple ways. Used simply it can replace all instances of the pattern provided with the replacement. A pair of values is returned, the modified string and the number of substitutions made. The optional fourth argument n can be used to limit the number of substitutions made:
Line 31:		Line 33:
	> = string.gsub("banana", "(a)(n)", function(a,b) return b..a end) -- reverse any "an"s		> = string.gsub("banana", "(a)(n)", function(a,b) return b..a end) -- reverse any "an"s
	bnanaa 2		bnanaa 2


	~~{{LUA}}~~

WoWWiki>Nenkasai: Added link

2008-07-30T00:49:24Z

Added link

← Older revision		Revision as of 00:49, 30 July 2008
Line 18:		Line 18:
	bnanaa 2		bnanaa 2

	If the replacement is a function, not a string, the arguments passed to the function are any captures that are made. If the function returns a string, the value returned is substituted back into the string. Just like string.find() we can use regular expressions to search in strings. Patterns are covered in the [http://lua-users.org/wiki/PatternsTutorial Patterns Tutorial on Lua-Users.org].		If the replacement is a function, not a string, the arguments passed to the function are any captures that are made. If the function returns a string, the value returned is substituted back into the string. Just like string.find() we can use regular expressions to search in strings. Patterns are covered in the [http://lua-users.org/wiki/PatternsTutorial Patterns Tutorial on Lua-Users.org], and [[HOWTO: Use Pattern Matching]].

	> = string.gsub("Hello Lua user", "(%w+)", print) -- print any words found		> = string.gsub("Hello Lua user", "(%w+)", print) -- print any words found

WoWWiki>Mikk: Use Lua/Libshortcut template. Change category from "LUA Functions" to "Lua functions".

2006-05-26T12:15:06Z

Use Lua/Libshortcut template. Change category from "LUA Functions" to "Lua functions".

← Older revision		Revision as of 12:15, 26 May 2006
Line 1:		Line 1:
			{{:Lua/Libshortcut\|gsub\|string.gsub}}
	string.gsub(s, pattern, replace [, n])		string.gsub(s, pattern, replace [, n])

Line 32:		Line 33:


	~~----~~		{{LUA}}
	{{~~WoW API~~}}

WoWWiki>Solariz: link to patterns tutorial added

2006-05-08T18:28:45Z

link to patterns tutorial added

← Older revision		Revision as of 18:28, 8 May 2006
Line 17:		Line 17:
	bnanaa 2		bnanaa 2

	If the replacement is a function, not a string, the arguments passed to the function are any captures that are made. If the function returns a string, the value returned is substituted back into the string. Just like string.find() we can use regular expressions to search in strings. Patterns are covered in the PatternsTutorial.		If the replacement is a function, not a string, the arguments passed to the function are any captures that are made. If the function returns a string, the value returned is substituted back into the string. Just like string.find() we can use regular expressions to search in strings. Patterns are covered in the [http://lua-users.org/wiki/PatternsTutorial Patterns Tutorial on Lua-Users.org].

	> = string.gsub("Hello Lua user", "(%w+)", print) -- print any words found		> = string.gsub("Hello Lua user", "(%w+)", print) -- print any words found

WoWWiki>Muert at 05:56, 4 January 2006

2006-01-04T05:56:12Z

← Older revision		Revision as of 05:56, 4 January 2006
Line 31:		Line 31:
	bnanaa 2		bnanaa 2

	~~[[Category:API Functions\|gsub]]~~
	~~[[Category:~~API ~~String Functions\|gsub]]~~		----
			{{WoW API}}

WoWWiki>Inglais at 19:06, 27 August 2005

2005-08-27T19:06:35Z

← Older revision		Revision as of 19:06, 27 August 2005
Line 30:		Line 30:
	> = string.gsub("banana", "(a)(n)", function(a,b) return b..a end) -- reverse any "an"s		> = string.gsub("banana", "(a)(n)", function(a,b) return b..a end) -- reverse any "an"s
	bnanaa 2		bnanaa 2

			[[Category:API Functions\|gsub]]
			[[Category:API String Functions\|gsub]]

WoWWiki>Sparsematrix at 02:49, 14 February 2005

2005-02-14T02:49:29Z

New page

string.gsub(s, pattern, replace [, n])

This is a very powerful function and can be used in multiple ways. Used simply it can replace all instances of the pattern provided with the replacement. A pair of values is returned, the modified string and the number of substitutions made. The optional fourth argument n can be used to limit the number of substitutions made:

> = string.gsub("Hello banana", "banana", "Lua user")
Hello Lua user 1
> = string.gsub("banana", "a", "A", 2) -- limit substitutions made to 2
bAnAna 2

If a capture is used this can be referenced in the replacement string using the notation %capture_index, e.g.,

> = string.gsub("banana", "(an)", "%1-") -- capture any occurances of "an" and replace
ban-an-a 2
> = string.gsub("banana", "a(n)", "a(%1)") -- brackets around n's which follow a's
ba(n)a(n)a 2
> = string.gsub("banana", "(a)(n)", "%2%1") -- reverse any "an"s
bnanaa 2

If the replacement is a function, not a string, the arguments passed to the function are any captures that are made. If the function returns a string, the value returned is substituted back into the string. Just like string.find() we can use regular expressions to search in strings. Patterns are covered in the PatternsTutorial.

> = string.gsub("Hello Lua user", "(%w+)", print) -- print any words found
Hello
Lua
user
3
> = string.gsub("Hello Lua user", "(%w+)", function(w) return string.len(w) end) -- replace with lengths
5 3 4 3
> = string.gsub("banana", "(a)", string.upper) -- make all "a"s found uppercase
bAnAnA 3
> = string.gsub("banana", "(a)(n)", function(a,b) return b..a end) -- reverse any "an"s
bnanaa 2