Module:Escape/doc

Usage

This module is designed as an way to escape strings in a customized manner. There are two ways to call this module:

From another module:

local escape = require('Module:Escape')

From a template:

 {{invoke:Escape|main|mode=|char=}}

By default, this module will escape the \ char. To escape the { char instead, you can do require('Module:Escape'):char('{') (or esc:char('{') if you've stored table returned by this module in the local variable esc). When used in a template, set |char= equal to the char code.

Template Example

While other modes are available, only |mode=kill is probably the one most useful outside of Module space. The first parameter is your text with escaped chars. The second parameter is a char or string or pattern you wish to remove.

{{#invoke:Escape|main
|mode=kill
|test { test {\{ test, \test, \{,test\ \\ \ {\ ,
|{
}}

test test { test, test, {,test \ ,

Module Example

Here's some sample output from the debug consol below the module editor:

local escape = require('Module:Escape') test = 'test, \\test, \\{,test\\\\ \\\\ \\\\\\\\' test2 = escape:char('{'):text(test) =test2 test, \test, \7b 044 7btest\\ \\ \\\\ test3 = escape:char('\\'):text(test2) =test3 test, 5c 0116 5cest, 5c 055 5cb 044 7btest5c 092 5c 5c 092 5c 5c 092 5c5c 092 5c test4 = escape:char('{', {undo = test3}) =test4 test, 5c 0116 5cest, 5c 055 5cb 044 7btest5c 092 5c 5c 092 5c 5c 092 5c5c 092 5c test4 = escape:char('\\', {undo = test3}) =test4 test, test, 7b 044 7btest\ \ \\ test5 = escape:char('{', {undo = test4}) =test5 == test true =escape:undo(test3)--doesn't work because char is still set to '{' in current session test, 5c 0116 5cest, 5c 055 5cb 044 7btest5c 092 5c 5c 092 5c 5c 092 5c5c 092 5c =escape:undo(test4) test, \test, \,test\\ \\ \\\\ =escape:char('\\'):undo(test3) test, test, 7b 044 7btest\ \ \\ =escape:char('{', {undo = escape:char('\\'):undo(test3)}) test, test, {,test\ \ \\ =test == escape:char('{', {undo = escape:char('\\'):undo(test3)}) false =test == escape:char('{', {undo = escape:char('\\'):undo(test3, '\\')}) true test, \test, \7b 044 7btest\\ \\ \\\\ local t = 'test { test {\\{ test, \\test, \\{,test\\ \\ \\ {\\' =t test { test {\{ test, \test, \{,test\ \ \ {\ test { test {\\{ test, \\test, \\{,test\\ \\ \\ {\\ local e = require('Module:Escape') local t2 = escape:text(t) local t3 = string.gsub(t2, '{', ) local t4 = escape:undo(t3) =t4 test test { test, test, {,test \ local tk0 = escape:kill(t, '{') =tk0 == t4 true

Template Testcases

Original:

test { test {\{ test, \test, \{,test\ \ \ {\

Using internal method to remove {:

{{#invoke:Escape|main|mode=kill|test { test {\{ test, \test, \{,test\ \ \ {\|{}}

test test { test, test, {,test \

Using {{replace}} to remove {:

{{#invoke:Escape|main|mode=undo|{{replace|{{#invoke:Escape|main|mode=text|test { test {\{ test, \test, \{,test\ \ \ {\}}|{|}}}}

test test { test, test, {,test \

No removal of { between escape/unescape (escape char not restored):

{{#invoke:Escape|main|mode=undo
|{{#invoke:Escape|main|mode=text|test { test {\{ test, \test, \{,test\ \ \ {\}}
}}

test { test {{ test, test, {,test {\

Restore to original after escape

{{#invoke:Escape|main|mode=undo
|{{#invoke:Escape|main|mode=text|test { test {\{ test, \test, \{,test\ \ \ {\}}
|\
}}

test { test {\{ test, \test, \{,test\ \ \ {\

Remove the word test if not escaped and then place a different escape char in the place of the old escape char (for use by something else):

Note: The '%' char is a special in Lua, so use '%%' if that is the desired replacement. Otherwise, just a single char is fine (or a word).

{{#invoke:Escape|main|mode=kill
|test { test {\{ test, \test, \{,test\ \ \ {\
|test
|%%
}}

{ {%{ , %test, %{,% % % {\