Difference between revisions of "Manual:Display Functions"

From Mudlet
Jump to navigation Jump to search
(Imcreasing headline levels for visibility)
(Adding redirect to lua functions page.)
 
(3 intermediate revisions by one other user not shown)
Line 1: Line 1:
{{TOC right}}
+
#REDIRECT [[Manual:Lua_Functions]]
= Display Functions =
+
The contents of this page have been moved to the [[Manual:Lua_Functions|Lua Functions]] page.
A collection of functions for displaying or formatting information on the screen.
 
 
 
==display==
 
; display(value)
 
: This function will do it's best to show whatever you ask it (a number, string, table, function). This function can be useful for seeing what values does a table have, for example. Note that this doesn't handle recursive references and will loop infinitely at the moment (Mudlet 2.0-test4). If a value is a string, it'll be in single quotes, and if it's a number, it won't be quoted.
 
 
 
;Example
 
<syntaxhighlight lang="lua">
 
-- ask it to display a table
 
display({a = "somevalue", 1,2,3})
 
-- or some other target
 
display(target)
 
</syntaxhighlight>
 
 
 
==showColors==
 
;showColors(columns, filterColor)
 
: shows the named colors currently available in Mudlet's color table. These colors are stored in '''color_table''', in table form. The format is ''color_table.colorName = {r,g,b}''.
 
: See Also: [[Manual:Lua_Functions#bg|bg()]], [[Manual:Lua_Functions#fg|fg()]], [[Manual:Lua_Functions#cecho|cecho()]]
 
 
 
;Parameters
 
* ''columns:''
 
: Optional: number of columns to print the color table in. Passed as a number.
 
* ''filterColor:''
 
: Optional: limits the display to only certain colours that contain this word.
 
 
 
;Example:
 
<syntaxhighlight lang="lua">
 
-- display as four columns:
 
showColors(4)
 
 
 
-- show only red colours:
 
showColors("red")
 
</syntaxhighlight>
 
The output for this is:
 
 
 
[[File:ShowColors.png|showColors(4)|border|center]]
 
 
 
[[Category:Mudlet Manual]]
 
[[Category:Mudlet API]]
 
 
 
==wrapLine==
 
;wrapLine( windowName, lineNumber )
 
:Wrap line lineNumber of mini console (window) windowName. This function will interpret \n characters, apply word wrap and display the new lines on the screen. This function may be necessary if you use deleteLine() and thus erase the entire current line in the buffer, but you want to do some further echo() calls after calling deleteLine(). You will then need to re-wrap the last line of the buffer to actually see what you have echoed and get you \n interpreted as newline characters properly. Using this function is no good programming practice and should be avoided. There are better ways of handling situations where you would call deleteLine() and echo afterwards.
 
 
 
;Example
 
<syntaxhighlight lang="lua">
 
--This will effectively have the same result as a call to deleteLine() but the buffer line will not be entirely removed.
 
--Consequently, further calls to echo() etc. sort of functions are possible without using wrapLine() unnecessarily.
 
 
 
selectString(line,1);
 
replace("");
 
</syntaxhighlight>
 

Latest revision as of 22:07, 10 July 2017

The contents of this page have been moved to the Lua Functions page.