Caleb Cooper: Created page with "This module provides an easy and efficient way to generate lengthy strings. == Usage == First, load the module. local newBuffer = require('Modu..."

2020-10-20T16:27:53Z

Created page with "This module provides an easy and efficient way to generate lengthy strings. == Usage == First, load the module. <syntaxhighlight lang="lua"> local newBuffer = require('Modu..."

New page

This module provides an easy and efficient way to generate lengthy strings.

== Usage ==

First, load the module.

<syntaxhighlight lang="lua">
local newBuffer = require('Module:OutputBuffer')
</syntaxhighlight>

Then, create the buffer and the functions that act on it.

<syntaxhighlight lang="lua">
local getBuffer, print, printf = newBuffer()
</syntaxhighlight>

=== getBuffer ===

<syntaxhighlight lang="lua">
local text = getBuffer(sep)
</syntaxhighlight>

Returns the contents of the buffer, with an optional separator string <var>sep</var>.

=== print ===

<syntaxhighlight lang="lua">
print(s)
</syntaxhighlight>

Adds the string <var>s</var> to the buffer.

=== printf ===

<syntaxhighlight lang="lua">
printf(s, ...)
</syntaxhighlight>

Adds the string <var>s</var> to the buffer. The string is formatted with any subsequent arguments, following the rules used for [[mw:Extension:Scribunto/Lua reference manual#String.format|string.format]].

== Example ==

<syntaxhighlight lang="lua">
local newBuffer = require('Module:OutputBuffer')
local p = {}

function p.main()
local getBuffer, print, printf = newBuffer()
print('Welcome to the English Wikipedia.')
printf('There are currently %d articles on this site.', mw.site.stats.articles)
return getBuffer(' ')
end

return p

-- Assuming this module's name is "TestModule", and that mw.site.stats.articles returns 4500000,
-- {{#invoke:TestModule|main}} would output:
-- "Welcome to the English Wikipedia. There are currently 4500000 articles on this site."
</syntaxhighlight>

<includeonly>{{#ifeq:{{SUBPAGENAME}}|sandbox | |

[[Category:Lua metamodules]]
}}</includeonly>

Module:OutputBuffer/doc - Revision history

Caleb Cooper: Created page with "This module provides an easy and efficient way to generate lengthy strings. == Usage == First, load the module. local newBuffer = require('Modu..."