Jump to content

Module:Arguments/doc

From Fifth Empire Wiki
Revision as of 02:51, 9 December 2013 by wikipedia>Mr. Stradivarius (start the documentation)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)

This is the documentation page for Module:Arguments

This module provides easy processing of arguments passed from #invoke. It is a meta-module, meant for use by other modules, and should not be called from #invoke directly. Its features include:

  • Easy trimming of arguments and removal of blank arguments.
  • Arguments can be passed by both the current frame and by the parent frame at the same time. (More details below.)
  • Arguments can be passed in directly from another Lua module or from the debug console.
  • Most features can be customized.

Basic use

First, you need to load the module. It contains one function, named getArgs.

<source lang="lua"> local getArgs = require('Module:Arguments').getArgs </source>

In the most basic scenario, you can use getArgs inside your main function.

<source lang="lua"> local getArgs = require('Module:Arguments').getArgs local p = {}

function p.main(frame) local args = getArgs(frame) -- Main module code goes here. end

return p </source>

However, the recommended practice is to use a function just for processing arguments from #invoke. This means that if someone calls your module from another Lua module you don't have to have a frame object available, which improves performance.

<source lang="lua"> local getArgs = require('Module:Arguments').getArgs local p = {}

function p._main(args) -- Main module code goes here. end

function p.main(frame) local args = getArgs(frame) return p._main(args) end

return p </source>