wow. that was easy: git mv core nucleus

[feisty_meow.git] / nucleus / library / timely / time_control.h

diff --git a/nucleus/library/timely/time_control.h b/nucleus/library/timely/time_control.h
new file mode 100644 (file)
index 0000000..d2391b4
--- /dev/null
+++ b/nucleus/library/timely/time_control.h
@@ -0,0 +1,48 @@
+#ifndef TIME_CONTROL_CLASS
+#define TIME_CONTROL_CLASS
+
+/*****************************************************************************\
+*                                                                             *
+*  Name   : time_control
+*  Author : Chris Koeritz
+*                                                                             *
+*******************************************************************************
+* Copyright (c) 1995-$now By Author.  This program is free software; you can  *
+* redistribute it and/or modify it under the terms of the GNU General Public  *
+* License as published by the Free Software Foundation; either version 2 of   *
+* the License or (at your option) any later version.  This is online at:      *
+*     http://www.fsf.org/copyleft/gpl.html                                    *
+* Please send any updates to: fred@gruntose.com                               *
+\*****************************************************************************/
+
+#include "earth_time.h"
+
+///#include <basis/astring.h>
+///#include <basis/contracts.h>
+///#include <basis/definitions.h>
+
+namespace timely {
+
+//! Provides some functions that affect time, or ones perception of time.
+
+class time_control : public virtual basis::nameable
+{
+public:
+  ~time_control() {}
+
+  static void sleep_ms(basis::un_int msec);
+    //!< a system independent name for a forced snooze measured in milliseconds.
+    /*!< the application will do nothing on the current thread for the amount of
+    time specified.  on some systems, if "msec" is zero, then the sleep will
+    yield the current thread's remaining timeslice back to other threads. */
+
+  bool set_time(const time_locus &new_time);
+    //!< makes the current time equal to "new_time".
+    /*!< This will only work if the operation is supported on this OS and if
+    the current user has the proper privileges. */
+};
+
+} //namespace.
+
+#endif
+