Manual:String Functions - Revision history

Missionz3r0: /* string.len, utf8.len */ #string.utf8.width -> #utf8.width

2025-04-07T14:03:19Z

string.len, utf8.len: #string.utf8.width -> #utf8.width

2025-04-07T14:01:32Z

string.len, utf8.len: See also: utf8.width

2025-04-07T13:50:56Z

string.gsub, utf8.gsub: add simple example, "hello world" -> "hello friends"

2024-05-29T11:23:02Z

string.sub, utf8.sub

2024-05-29T11:16:06Z

string.match, utf8.match

2024-05-29T11:12:31Z

string.gmatch, utf8.gmatch

2024-05-29T11:11:09Z

string.gfind

2024-05-08T07:06:26Z

string.split: version info

2024-01-23T20:25:36Z

2023-08-13T15:25:52Z

string.dump: this part was running instead of returning a function

@@ Line 546: / Line 546: @@
 : string.len() works with English text only, use utf8.len() for the international version.
-: See also: [[#string.utf8.width|utf8.width]]
+: See also: [[#utf8.width|utf8.width]]
 ;Parameters:

@@ Line 545: / Line 545: @@
 :Receives a string and returns its length. The empty string "" has length 0. Embedded zeros are counted, so "a\000bc\000" has length 5.
 : string.len() works with English text only, use utf8.len() for the international version.
 ;Parameters:

@@ Line 516: / Line 516: @@
 ;Example
 <syntaxhighlight lang=lua>
       x = string.gsub("hello world", "(%w+)", "%1 %1")
       --> x="hello hello world world"

@@ Line 723: / Line 723: @@
 : string.sub() works with English text only, use utf8.sub() for the international version.
 ;Example
-''Need example''
 ==string.title==

@@ Line 577: / Line 577: @@
 : string.match() works with English text only, use utf8.match() for the international version.
 ;Example
-''Need example''
 == string.patternEscape, utf8.patternEscape==

@@ Line 482: / Line 482: @@
 ;string.gmatch(text, pattern) or utf8.gmatch
 : Returns an iterator function that, each time it is called, returns the next captures from pattern over string text. If pattern specifies no captures, then the whole match is produced in each call.
 As an example, the following loop
 <syntaxhighlight lang=lua>
@@ Line 496: / Line 498: @@
       end</syntaxhighlight>
 For this function, a '^' at the start of a pattern does not work as an anchor, as this would prevent the iteration.
-: string.gmatch() works with English text only, use utf8.gmatch() for the international version.
-;Example
+string.gmatch() works with English text only, use utf8.gmatch() for the international version.
 ==string.gsub, utf8.gsub==

@@ Line 477: / Line 477: @@
 ==string.gfind==
 ;string.gfind()
-: This is an old version of what is now string.gmatch. Use string.gmatch instead.
+: This is an old version of what is now [[Manual:Technical_Manual#string.gmatch.2C_utf8.gmatch|string.gmatch]]. Use [[Manual:Technical_Manual#string.gmatch.2C_utf8.gmatch|string.gmatch]] instead.
 ==string.gmatch, utf8.gmatch==

@@ Line 665: / Line 665: @@
 * ''delimiter:''
 : The delimiter to use when splitting the string. Passed as a string, and allows for [http://www.lua.org/pil/20.2.html Lua pattern types]. Use % to escape here (and %% to escape a stand-alone %).
 {{ Note }} as of Mudlet 4.7+, delimiter will default to " " if not provided.
 {{ Note }} as of Mudlet 4.7+, using "" (empty string) for the delimiter will return the string as a table of characters. IE string.split("This","") will return as {"T", "h", "i", "s"}. Prior to 4.7 using empty string as the delimiter would error after hanging temporarily.
 ;Example

← Older revision		Revision as of 20:25, 23 January 2024
Line 87:		Line 87:

	{{MudletVersion\|4.11}}		{{MudletVersion\|4.11}}
		+	{{note}} Using f is slower than using concatenation with the '..' operator by a fair bit, due to the way it has to gather scope for supporting local variables. For aliases or single calls this isn't so bad, but if you're looping a large table and building a string then f's slowness will really start to show and bring performance down.
	; Example:		; Example:

@@ Line 332: / Line 332: @@
 ;Example
 <syntaxhighlight lang="lua">
-testString = string.dump(echo("this is a string"))
+testString = string.dump(function() echo("this is a string") end)
 --The following should then echo "this is a string"
 loadstring(testString)()