Function Cron_AddTask

src/cron/cron.c:262–283

create a new CRON task

// create a new CRON task
CronTaskHandle Cron_AddTask
(
	uint when,          // number of miliseconds until task invocation
	CronTaskCB work,    // callback to call when task is due
	CronTaskFree free,  // [optional] task private data free function
	void *pdata         // [optional] private data to pass to callback
) {
	ASSERT(work   != NULL);
	ASSERT(cron   != NULL);
	ASSERT(!(free != NULL && pdata == NULL));

	CRON_TASK *task = rm_malloc(sizeof(CRON_TASK));

	task->cb    = work;
	task->due   = due_in_ms(when);
	task->free  = free;
	task->pdata = pdata;

	CRON_InsertTask(task);

	return (uintptr_t)task;
}

// tries to abort given task
// in case task is currently being executed, it will wait for it to finish