library-mirrors/cron.lua
1
0
Fork 0
mirror of https://github.com/kikito/cron.lua.git synced 2024-12-19 18:34:20 +00:00
Code Issues Actions Packages Projects Releases Wiki Activity

made README more clear. fixes #8

Browse Source
This commit is contained in:
kikito 2012-12-02 22:29:34 +01:00
parent 3ffb5130fa
commit 5ba2c90e9c
1 changed files with 24 additions and 9 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

33
README.md
View File

@ -26,32 +26,47 @@ Examples
cron.after(5, printMessage)
cron.after(5, print, 'Hello')
cron.update(5) -- will print 'Hello' twice
cron.update(5) -- will print 'Hello' twice (once per each cron.after)
-- this will print the message periodically:
local id = cron.every(10, printMessage)
cron.update(5) -- nothing
cron.update(4) -- nothing
cron.update(12) -- prints 'Hello' twice
cron.update(5) -- nothing (total time: 5)
cron.update(4) -- nothing (total time: 9)
cron.update(12) -- prints 'Hello' twice (total time is now 21)
cron.cancel(id) -- stops the execution the element defined by id. Works with periodical or one-time actions.
cron.reset() -- stops all the current actions, both timed ones and periodical ones.
Some tag examples:
Examples using tags:
-- This has the same effect of cron.after(2, showMenu), except that the
-- time entry is tagged with the tags 'main-menu' and 'menu'
cron.tagged('main-menu', 'menu').after(2, showMenu)
cron.tagged('main-menu', 'menu').every(2, showMenu)
-- after also has a tagged version:
cron.tagged('menu').after(10, doSomething)
-- This updates the time entries tagged with the tag 'menu', but not the rest
cron.tagged('menu').update(2)
-- cron.cancel does not admit filtering via tags, but it admits tags as params
-- the previous call is equivalent to this one:
cron.tagged('main-menu').cancel()
-- cron.update updates all the time entries, no matter how they are tagged:
cron.update(2) -- updates everything
-- the tagged version of cron.cancel does not take params:
cron.tagged('main-menu').cancel() -- cancels any entry tagged 'main-menu'
-- A very nice thing: You are not restrited to using strings for tags. Any Lua
-- object (including tables) can be used. This way, you can link time entries
-- to specific instances.
local player = ... -- some table representing the player
cron.tagged(player, 'movement').after(10, startBoredAnimation)
...
cron.tagged(player).cancel() -- cancel all time entries tagged with the player
cron.tagged(player, 'movement') -- cancell the player entries related with movement only
Gotchas / Warnings
==================