repeat decorator parameter.

Author: DEntisT

doc/decorators.md

@@ -40,7 +40,7 @@ void mytask() public;
 
 # `this` keyword
 
-- This keyword is used for modifying decorator argument values, without a specific order.
+- This keyword is used for modifying decorator parameter values, without a specific order.
 
 ```cpp
 @task;
@@ -61,4 +61,37 @@ void mytask() public;
 {
 	console.println("Task works!");
 }
-```
+```
+
+## `@task` parameters
+
+### `interval` (integer)
+
+- How much does it take till the timer is (re)called.
+
+```cpp
+@task;
+	this->interval=1000;
+void mytask() public;
+{
+	console.println("Task works!");
+}
+```
+
+**NOTE**: This parameter's default value is 0, so it is obligatory to set it before creating the task unless you want to rape your logs.
+
+### `repeat` (boolean)
+
+- Will the timer recall after being called once?
+
+```cpp
+@task;
+	this->interval=1000;
+	this->repeat=false;
+void mytask() public;
+{
+	console.println("Task works!");
+}
+```
+
+**NOTE**: Now the timer will be called only once 1 second after `main` external-structured function gets called. Default value of this parameter is `true` so you don't need to set it unless you want to create a non-repeating timer.

scriptfiles/index.ps

@@ -718,7 +718,7 @@ stock dpp_subexecute__3(const code[])
 ////////////////////////////////////////////////
 
 
-stock dpp_createtask(const name[], interval)
+stock dpp_createtask(const name[], interval, repeat)
 {
     dpp_symbolcheck__(name);
     for(new i; i < dpp_maxtasks; i++)
@@ -729,6 +729,7 @@ stock dpp_createtask(const name[], interval)
             dpp_validtask[i] = 1;
             strmid(dpp_taskname[i], name, 0, 64, 64);
             dpp_interval[i] = interval;
+            dpp_repeat[i] = repeat;
             return 1;
         }
     }

src/modules/header.inc

@@ -815,9 +815,10 @@ stock dpp_process(line[])
         {
             if(!strcmp(tokengroup2[0], "void"))
             {
-                dpp_createtask(arguments[0],dpp_interval__);
+                dpp_createtask(arguments[0],dpp_interval__,dpp_repeat__);
                 dpp_event = dpp_event_task;
                 dpp_interval__=0;
+                dpp_repeat__=1;
             }
         }
         dpp_lastdeco = dpp_deco_invalid;
@@ -1814,6 +1815,36 @@ stock dpp_process(line[])
 
                 dpp_interval__ = strval(thisargs[1]);
             }
+            if(!strcmp(thisargs[0],"repeat"))
+            {
+                new i = 1;
+                dpp_removeslashes(thisargs[i]);
+                dpp_argclasscheck(thisargs[i]);
+                dpp_argoclasscheck(thisargs[i]);
+                dpp_argarraycheck(thisargs[i]);
+                dpp_argfunccheck(thisargs[i]);
+                dpp_argvarcheck(thisargs[i]);
+                dpp_argmathcheck(thisargs[i]);
+                dpp_argformargcheck(thisargs[i]);
+                dpp_argsystemval(thisargs[i]);
+                CallLocalFunction("dpp_arginstruct", "s", thisargs[i]);
+                CallLocalFunction("dpp_argenumcheck", "s", thisargs[i]);
+                CallLocalFunction("dpp_argtagcheck", "s", thisargs[i]);
+
+                dpp_formatarg(thisargs[i]);
+
+                new value=1;
+                if(!strcmp(thisargs[1],"true"))
+                {
+                    value=1;
+                }
+                if(!strcmp(thisargs[1],"false"))
+                {
+                    value=0;
+                }
+
+                dpp_repeat__ = value;
+            }
             return 1;
         }
         return 1;

src/modules/interpreter.inc

@@ -26,7 +26,7 @@ public dpp_taskinit()
     {
     	if(dpp_validtask[i] == 1)
     	{
-    		dpp_internaltasks[i] = SetTimerEx("dpp_runtask", dpp_interval[i], true, "i", i);
+    		dpp_internaltasks[i] = SetTimerEx("dpp_runtask", dpp_interval[i], bool:dpp_repeat[i], "i", i);
     	}
     }
     return 1;

src/modules/tasks.inc

@@ -290,6 +290,7 @@ new dpp_validtask[dpp_maxtasks__];
 new dpp_taskname[dpp_maxtasks__][dpp_maxsymbolchar];
 new dpp_taskcodeblock[dpp_maxtasks__][dpp_buffersize];
 new dpp_interval[dpp_maxtasks__];
+new dpp_repeat[dpp_maxtasks__];
 //-----------------------------------------------------------
 //iterators
 new dpp_validiter[dpp_maxiter__];
@@ -458,7 +459,7 @@ new dpp_stkreg[DPP_STKSIZE][dpp_maxsymbolchar];
 new dpp_allowcollision;
 #define @emit__%0\32;%1\10;%3 dpp_asm__(%1);
 //-----------------------------------------------------------
-#define dpp_maxkwords 53
+#define dpp_maxkwords 54
 new dpp_kwords[dpp_maxkwords][256] = {
     "public",
     "inline",
@@ -512,7 +513,9 @@ new dpp_kwords[dpp_maxkwords][256] = {
     "true",
     "false",
     "this",
-    "interval"
+    "interval",
+    "repeat"
 };
 //-----------------------------------------------------------
-new dpp_interval__;
+new dpp_interval__;
+new dpp_repeat__=1;