Upstream version 10.39.225.0

[platform/framework/web/crosswalk.git] / src / mojo / public / cpp / utility / run_loop.h

diff --git a/src/mojo/public/cpp/utility/run_loop.h b/src/mojo/public/cpp/utility/run_loop.h
index e02f645..359208d 100644 (file)
--- a/src/mojo/public/cpp/utility/run_loop.h
+++ b/src/mojo/public/cpp/utility/run_loop.h
@@ -40,13 +40,13 @@ class RunLoop {
   void RemoveHandler(const Handle& handle);
   bool HasHandler(const Handle& handle) const;
 
-  // Runs the loop servicing handles as they are ready. This returns when Quit()
-  // is invoked, or there no more handles.
+  // Runs the loop servicing handles and tasks as they are ready. This returns
+  // when Quit() is invoked, or there are no more handles nor tasks.
   void Run();
 
-  // Runs the loop servicing any handles that are ready. Does not wait for
-  // handles to become ready before returning. Returns early if Quit() is
-  // invoked.
+  // Runs the loop servicing any handles and tasks that are ready. Does not wait
+  // for handles or tasks to become ready before returning. Returns early if
+  // Quit() is invoked.
   void RunUntilIdle();
 
   void Quit();
@@ -76,18 +76,38 @@ class RunLoop {
 
   typedef std::map<Handle, HandlerData> HandleToHandlerData;
 
-  // Do one unit of delayed work, if eligible.
-  void DoDelayedWork();
+  // Used for NotifyHandlers to specify whether HandlerData's |deadline|
+  // should be checked prior to notifying.
+  enum CheckDeadline {
+    CHECK_DEADLINE,
+    IGNORE_DEADLINE
+  };
+
+  // Mode of operation of the run loop.
+  enum RunMode {
+    UNTIL_EMPTY,
+    UNTIL_IDLE
+  };
+
+  // Runs the loop servicing any handles and tasks that are ready. If
+  // |run_mode| is |UNTIL_IDLE|, does not wait for handles or tasks to become
+  // ready before returning. Returns early if Quit() is invoked.
+  void RunInternal(RunMode run_mode);
+
+  // Do one unit of delayed work, if eligible. Returns true is a task was run.
+  bool DoDelayedWork();
 
-  // Waits for a handle to be ready. Returns after servicing at least one
-  // handle (or there are no more handles) unless |non_blocking| is true,
-  // in which case it will also return if servicing at least one handle
-  // would require blocking. Returns true if a RunLoopHandler was notified.
+  // Waits for a handle to be ready or until the next task must be run. Returns
+  // after servicing at least one handle (or there are no more handles) unless
+  // a task must be run or |non_blocking| is true, in which case it will also
+  // return if no task is registered and servicing at least one handle would
+  // require blocking. Returns true if a RunLoopHandler was notified.
   bool Wait(bool non_blocking);
 
-  // Notifies any handlers whose deadline has expired. Returns true if a
-  // RunLoopHandler was notified.
-  bool NotifyDeadlineExceeded();
+  // Notifies handlers of |error|.  If |check| == CHECK_DEADLINE, this will
+  // only notify handlers whose deadline has expired and skips the rest.
+  // Returns true if a RunLoopHandler was notified.
+  bool NotifyHandlers(MojoResult error, CheckDeadline check);
 
   // Removes the first invalid handle. This is called if MojoWaitMany() finds an
   // invalid handle. Returns true if a RunLoopHandler was notified.