Method to determine if a task exists in a task list, and return it.

nag/lib/Task.php

@@ -745,6 +745,26 @@ public function reset()
         $this->_inlist = false;
     }
 
+    /**
+     * Return the task, if present anywhere in this tasklist, regardless of
+     * child depth.
+     *
+     * @param  string $taskId  The task id we are looking for.
+     *
+     * @return Nag_Task|false  The task object, if found. Otherwise false.
+     */
+    public function hasTask($taskId)
+    {
+        $this->reset();
+        while ($task = $this->each()) {
+            if ($task->id == $taskId) {
+                return $task;
+            }
+        }
+
+        return false;
+    }
+
     /**
      * Returns the next task iterating through all tasks and sub tasks.
      *