Lua tips - Revision history

Guessed: Syntax color the Lua code, fix a few typo's

2011-09-04T22:47:01Z

Syntax color the Lua code, fix a few typo's

Javier: Category:Development

2010-04-13T05:02:37Z

Category:Development

Javier at 03:25, 9 April 2010

2010-04-09T03:25:52Z

Javier at 19:25, 23 February 2010

2010-02-23T19:25:00Z

Javier: New page: Lua is a very complete and powerful language, the full reference is at Www.lua.org. This page attempts to help with common pitfalls, especially those that are likely to appear on ...

2010-02-23T19:21:40Z

New page: Lua is a very complete and powerful language, the full reference is at Www.lua.org. This page attempts to help with common pitfalls, especially those that are likely to appear on ...

New page

Lua is a very complete and powerful language, the full reference is at [[Www.lua.org]]. This page attempts to help with common pitfalls, especially those that are likely to appear on scripting the MIOS system.

== Get a default ==

It's customary for some functions to return a '''nil''' value to mean 'nothing'; for example, luup.variable_get() returns '''nil''' if you ask for a non-existant variable, or a wrong service or device.  Unfortunately, using that '''nil'''
<pre>local value = luup.variable_get("urn:upnp-org:serviceId:Dimming1","LoadLevelTarget",5)
luup.log("Dim level for device #5 is: " .. value)</pre>
This works perfectly if the device #5 supports the "Dimming" service and has a "LoadLevelTarget" variable; but if you have the wrong device, the whole script would simply fail at the next line, where it tries to concatenate a string with a '''nil''' value.

A common solution is to use the '''or''' keyword to give your variable a default value: 
<pre>local value = luup.variable_get("urn:upnp-org:serviceId:Dimming1","LoadLevelTarget",5) '''or "-none-"'''
luup.log("Dim level for device #5 is: " .. value)

</pre>
Now, if anything gets wrong reading the value, your variable will have a value of "-none-".  In most cases, it's simpler to use the empty string "" as the default value.

 

== Hold on to your locals ==

It's always good practice to avoid 'polluting' the global variable space.  Any temporal variable should be defined with the '''local''' keyword.  Note that making a variable '''local''' means it's accessible only within the current block, for example:
<pre>if value > 5 then

local msg = "good!"

end

loop.log (msg)</pre>
This won't work correctly, the 'msg' is  local to the 'then' block; it can't be accessed in any other context.  The loop.log() function will be called using a global 'msg' variable, which is probably '''nil''', or even worse, has the wrong value. 

But that also means you can define an outer block, and make your locals 'not so local'.  For example: 
<pre>do

local innerval = 0

function increment()

innerval = innerval + 1

end

function getit()

return innerval

end

end
</pre>
In this example, 'innerval' is local to the outer block, which contains two functions.  Both functions can access that variable; but no other code can.  This is an example of encapsulation.  Using this, you can be sure that no other code can mess with your variables.  In this example, it's easy to see that innerval will only be incremented, there's no way to go backwards until the system is restarted. 

In many cases in which you might want a global variable, it could be better to use a local variable for a bigger block, even a block that surrounds your whole module.

 

== Mark your own turf ==

When you do have to use a global variable, keep in mind that any other code could access it and even modify it.  We're not talking about malitious intentions, just about unintended interactions between two different parts of the code. likely written by different people.

To reduce the probability of errors, a common technique is to use a prefix that is likely to be unique.  For example, a plugin called "Energy Monitor" could start all global variables with 'enmon_'.

Somewhat better is to join all global variables in a single global variable that holds a table:
<pre>energymonitor = {}
energymonitor.starttime = os.time()
energymonitor.devicecount = 15</pre>
Note that this is what Lua modules do: each one is defined as a single table.  Even the standard library follows this convention, all string related functions are contained in the global 'string' table.

One (current) limitation is that any function that you want to be called by Luup has to be global, not inside a global table.  For those, the best way is to use a unique prefix.

@@ Line 6: / Line 6: @@
 It's customary for some functions to return a&nbsp;'''nil'''&nbsp;value to mean 'nothing'; for example, luup.variable_get() returns '''nil''' if you ask for a non-existant variable, or a wrong service or device. &nbsp;Unfortunately, using that '''nil''' to build a string causes an error.  For example:
-<pre>local value = luup.variable_get("urn:upnp-org:serviceId:Dimming1","LoadLevelTarget",5)
+<source lang="lua">
-luup.log("Dim level for device #5 is: " .. value)</pre>
+  local value = luup.variable_get("urn:upnp-org:serviceId:Dimming1", "LoadLevelTarget", 5)
 This works perfectly if the device #5 supports the "Dimming" service and has a "LoadLevelTarget" variable; but if you have the wrong device, the whole script would simply fail at the next line, where it tries to concatenate a string with a '''nil''' value.
 A common solution is to use the '''or''' keyword to give your variable a default value:<br>
-<pre>local value = luup.variable_get("urn:upnp-org:serviceId:Dimming1","LoadLevelTarget",5) or "-none-"
+<source lang="lua">
-luup.log("Dim level for device #5 is: " .. value)
+  local value = luup.variable_get("urn:upnp-org:serviceId:Dimming1", "LoadLevelTarget", 5) or "-none-"
 Now, if anything gets wrong reading the value, your variable will have a value of "-none-". &nbsp;In most cases, it's simpler to use the empty string "" as the default value.
@@ Line 22: / Line 26: @@
 It's always good practice to avoid 'polluting' the global variable space. &nbsp;Any temporal variable should be defined with the '''local''' keyword. &nbsp;Note that making a variable '''local''' means it's accessible only within the current block, for example:
-<pre>if value &gt; 5 then
+<source lang="lua">
+  if (value > 5) then
-  local msg = "good!"
+    local msg = "good!"
+  end
 end
-loop.log (msg)</pre>
+  luup.log(msg)
 This won't work correctly, the 'msg' is &nbsp;local to the 'then' block; it can't be accessed in any other context. &nbsp;The loop.log() function will be called using a global 'msg' variable, which is probably '''nil''', or even worse, could have the wrong value.<br>
 But that also means you can define an outer block, and make your locals 'not so local'. &nbsp;For example:<br>
-<pre>do
+<source lang="lua">
-  local innerval = 0
+    function increment()
+      innerval = innerval + 1
+    end
-  function increment()
-−
-    innerval = innerval + 1
    end
+</source>
-−
-  function getit()
-−
-    return innerval
-−
-  end
-−
-end
-</pre>
 In this example, 'innerval' is local to the outer block, which contains two functions. &nbsp;Both functions can access that variable; but no other code can. &nbsp;This is an example of encapsulation. &nbsp;Using this, you can be sure that no other code can mess with your variables. &nbsp;In this example, it's easy to see that innerval will only be incremented, there's no way to go backwards until the system is restarted.<br>
 In many cases in which you might want a global variable, it could be better to use a local variable for a bigger block, even a block that surrounds your whole module.
 == Mark your own turf  ==
@@ Line 65: / Line 62: @@
 Somewhat better is to join all global variables in a single global variable that holds a table:
-<pre>energymonitor = {}
+<source lang="lua">
-energymonitor.starttime = os.time()
+  energymonitor = {}
-energymonitor.devicecount = 15</pre>
+  energymonitor.starttime = os.time()
 Note that this is what Lua modules do: each one is defined as a single table.&nbsp; Even the standard library follows this convention, all string related functions are contained in the global 'string' table.
 One (current) limitation is that any function that you want to be called by Luup has to be global, not inside a global table. &nbsp;For those, the best way is to use a unique prefix.

← Older revision		Revision as of 05:02, 13 April 2010
Line 1:		Line 1:
		+	[[Category:Development]]
	Lua is a very complete and powerful language, the full reference is at http://www.lua.org. This page attempts to help with common pitfalls, especially those that are likely to appear on scripting the MIOS system.		Lua is a very complete and powerful language, the full reference is at http://www.lua.org. This page attempts to help with common pitfalls, especially those that are likely to appear on scripting the MIOS system.

@@ Line 3: / Line 3: @@
 == Get a default  ==
-It's customary for some functions to return a&nbsp;'''nil'''&nbsp;value to mean 'nothing'; for example, luup.variable_get() returns '''nil''' if you ask for a non-existant variable, or a wrong service or device. &nbsp;Unfortunately, using that '''nil'''
+It's customary for some functions to return a&nbsp;'''nil'''&nbsp;value to mean 'nothing'; for example, luup.variable_get() returns '''nil''' if you ask for a non-existant variable, or a wrong service or device. &nbsp;Unfortunately, using that '''nil''' to build a string causes an error.  For example:
 <pre>local value = luup.variable_get("urn:upnp-org:serviceId:Dimming1","LoadLevelTarget",5)
 luup.log("Dim level for device #5 is: " .. value)</pre>
@@ Line 9: / Line 10: @@
 A common solution is to use the '''or''' keyword to give your variable a default value:<br>
-<pre>local value = luup.variable_get("urn:upnp-org:serviceId:Dimming1","LoadLevelTarget",5) '''or "-none-"'''
+<pre>local value = luup.variable_get("urn:upnp-org:serviceId:Dimming1","LoadLevelTarget",5) or "-none-"
 luup.log("Dim level for device #5 is: " .. value)
@@ Line 27: / Line 28: @@
 loop.log (msg)</pre>
-This won't work correctly, the 'msg' is &nbsp;local to the 'then' block; it can't be accessed in any other context. &nbsp;The loop.log() function will be called using a global 'msg' variable, which is probably '''nil''', or even worse, has the wrong value.<br>
+This won't work correctly, the 'msg' is &nbsp;local to the 'then' block; it can't be accessed in any other context. &nbsp;The loop.log() function will be called using a global 'msg' variable, which is probably '''nil''', or even worse, could have the wrong value.<br>
 But that also means you can define an outer block, and make your locals 'not so local'. &nbsp;For example:<br>

← Older revision		Revision as of 19:25, 23 February 2010
Line 1:		Line 1:
−	Lua is a very complete and powerful language, the full reference is at~~ [[Www~~.lua.org]]. This page attempts to help with common pitfalls, especially those that are likely to appear on scripting the MIOS system.	+	Lua is a very complete and powerful language, the full reference is at http://www.lua.org. This page attempts to help with common pitfalls, especially those that are likely to appear on scripting the MIOS system.

	== Get a default ==		== Get a default ==