Modhul:String2

Dhokumèntasi modhul iki bisa digawé ing Modhul:String2/doc

local p = {}p.upper = function(frame)local s = mw.text.trim(frame.args[1] or "")return string.upper(s)endp.lower = function(frame)local s = mw.text.trim(frame.args[1] or "")return string.lower(s)endp.sentence = function (frame )frame.args[1] = string.lower(frame.args[1])return p.ucfirst(frame)endp.ucfirst = function (frame )local s =  mw.text.trim( frame.args[1] or "" )local s1 = ""-- if it's a list chop off and (store as s1) everything up to the first <li>local lipos = mw.ustring.find(s, "<li>" )if lipos thens1 = mw.ustring.sub(s, 1, lipos + 3)s = mw.ustring.sub(s, lipos + 4)end-- s1 is either "" or the first part of the list markup, so we can continue-- and prepend s1 to the returned stringlocal letterposif mw.ustring.find(s, "^%[%[[^|]+|[^%]]+%]%]") then-- this is a piped wikilink, so we capitalise the text, not the pipelocal __, letterpos = mw.ustring.find(s, "|%A*%a") -- find the first letter after the pipeelseletterpos = mw.ustring.find(s, '%a')endif letterpos thenlocal first = mw.ustring.sub(s, 1, letterpos - 1)local letter = mw.ustring.sub(s, letterpos, letterpos)local rest = mw.ustring.sub(s, letterpos + 1)return s1 .. first .. mw.ustring.upper(letter) .. restelsereturn s1 .. sendendp.title = function (frame )-- http://grammar.yourdictionary.com/capitalization/rules-for-capitalization-in-titles.html-- recommended by The U.S. Government Printing Office Style Manual:-- "Capitalize all words in titles of publications and documents,-- except a, an, the, at, by, for, in, of, on, to, up, and, as, but, or, and nor."local alwayslower = {['a'] = 1, ['an'] = 1, ['the'] = 1,['and'] = 1, ['but'] = 1, ['or'] = 1, ['for'] = 1,['nor'] = 1, ['on'] = 1, ['in'] = 1, ['at'] = 1, ['to'] = 1,['from'] = 1, ['by'] = 1, ['of'] = 1, ['up'] = 1 }local res = ''local s =  mw.text.trim( frame.args[1] or "" )local words = mw.text.split( s, " ")for i, s in ipairs(words) dos = string.lower( s )if( i > 1 and alwayslower[s] == 1) then-- leave in lowercaseelses = mw.getContentLanguage():ucfirst(s)endwords[i] = sendreturn table.concat(words, " ")end-- findlast finds the last item in a list-- the first unnamed parameter is the list-- the second, optional unnamed parameter is the list separator (default = comma space)-- returns the whole list if separator not foundp.findlast = function(frame)local s =  mw.text.trim( frame.args[1] or "" )local sep = frame.args[2] or ""if sep == "" then sep = ", " endlocal pattern = ".*" .. sep .. "(.*)"a, b, last = s:find(pattern)if a thenreturn lastelsereturn sendend-- stripZeros finds the first number and strips leading zeros (apart from units)-- e.g "0940" -> "940"; "Year: 0023" -> "Year: 23"; "00.12" -> "0.12"p.stripZeros = function(frame)local s = mw.text.trim(frame.args[1] or "")local n = tonumber( string.match( s, "%d+" ) ) or ""s = string.gsub( s, "%d+", n, 1 )return send-- nowiki ensures that a string of text is treated by the MediaWiki software as just a string-- it takes an unnamed parameter and trims whitespace, then removes any wikicodep.nowiki = function(frame)local str = mw.text.trim(frame.args[1] or "")return mw.text.nowiki(str)end-- posnq (position, no quotes) returns the numerical start position of the first occurrence-- of one piece of text ("match") inside another ("str").-- It returns nil if no match is found, or if either parameter is blank.-- It takes the text to be searched in as the first unnamed parameter, which is trimmed.-- It takes the text to match as the second unnamed parameter, which is trimmed and-- any double quotes " are stripped out.p.posnq = function(frame)local args = frame.argslocal pargs = frame:getParent().argsfor k, v in pairs(pargs) doargs[k] = vendlocal str = mw.text.trim(args[1] or args.source or "")local match = mw.text.trim(args[2] or args.target or ""):gsub('"', '')if str == "" or match == "" then return nil endlocal plain = mw.text.trim(args[3] or args.plain or "")if plain == "false" then plain = false else plain = true endlocal nomatch = mw.text.trim(args[4] or args.nomatch or "")-- just take the start positionlocal pos = mw.ustring.find(str, match, 1, plain) or nomatchreturn posend-- split splits text at boundaries specified by separator-- and returns the chunk for the index idx (starting at 1)-- #invoke:String2 |split |text |separator |index |true/false-- #invoke:String2 |split |txt=text |sep=separator |idx=index |plain=true/false-- if plain is false/no/0 then separator is treated as a Lua pattern - defaults to plain=truep.split = function(frame)local args = frame.argsif not(args[1] or args.txt) then args = frame:getParent().args endlocal txt = args[1] or args.txt or ""if txt == "" then return nil endlocal sep = (args[2] or args.sep or ""):gsub('"', '')local idx = tonumber(args[3] or args.idx) or 1local plain = (args[4] or args.plain or "true"):sub(1,1)plain = (plain ~= "f" and plain ~= "n" and plain ~= "0")local splittbl = mw.text.split( txt, sep, plain )if idx < 0 then idx = #splittbl + idx + 1 endreturn splittbl[idx]end-- val2percent scans through a string, passed as either the first unnamed parameter or |txt=-- it converts each number it finds into a percentage and returns the resultant string.p.val2percent = function(frame)local args = frame.argsif not(args[1] or args.txt) then args = frame:getParent().args endlocal txt = mw.text.trim(args[1] or args.txt or "")if txt == "" then return nil endlocal function v2p (x)x = (tonumber(x) or 0) * 100if x == math.floor(x) then x = math.floor(x) endreturn x .. "%"endtxt = txt:gsub("%d[%d%.]*", v2p) -- store just the stringreturn txtend-- one2a scans through a string, passed as either the first unnamed parameter or |txt=-- it converts each occurrence of 'one ' into either 'a ' or 'an ' and returns the resultant string.p.one2a = function(frame)local args = frame.argsif not(args[1] or args.txt) then args = frame:getParent().args endlocal txt = mw.text.trim(args[1] or args.txt or "")if txt == "" then return nil endtxt = txt:gsub(" one ", " a "):gsub("^one", "a"):gsub("One ", "A "):gsub("a ([aeiou])", "an %1"):gsub("A ([aeiou])", "An %1")return txtend-- findpagetext returns the position of a piece of text in a page-- First positional parameter or |text is the search text-- Optional parameter |title is the page title, defaults to current page-- Optional parameter |plain is either true for plain search (default) or false for Lua pattern search-- Optional parameter |nomatch is the return value when no match is found; default is nilp._findpagetext = function(args)-- process parameterslocal nomatch = args.nomatch or ""if nomatch == "" then nomatch = nil end--local text = mw.text.trim(args[1] or args.text or "")if text == "" then return nil end--local title = args.title or ""local titleobjif title == "" thentitleobj = mw.title.getCurrentTitle()elsetitleobj = mw.title.new(title)end--local plain = args.plain or ""if plain:sub(1, 1) == "f" then plain = false else plain = true end-- get the page content and look for 'text' - return position or nomatchcontent = titleobj:getContent()return mw.ustring.find(content, text, 1, plain) or nomatch-- returns multiple valuesendp.findpagetext = function(frame)local args = frame.argslocal pargs = frame:getParent().argsfor k, v in pairs(pargs) doargs[k] = vendif not (args[1] or args.text) then return nil end-- just the first valuereturn (p._findpagetext(args))endreturn p