From 08903414e3546bc2c76bef73b2337ccf79886530 Mon Sep 17 00:00:00 2001
From: Boris Kolpackov <boris@codesynthesis.com>
Date: Thu, 18 Jun 2015 14:41:44 +0200
Subject: Move path and filesystem from build2 to libbutl

---
 butl/timestamp | 54 ++++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 54 insertions(+)
 create mode 100644 butl/timestamp

(limited to 'butl/timestamp')

diff --git a/butl/timestamp b/butl/timestamp
new file mode 100644
index 0000000..76df07b
--- /dev/null
+++ b/butl/timestamp
@@ -0,0 +1,54 @@
+// file      : butl/timestamp -*- C++ -*-
+// copyright : Copyright (c) 2014-2015 Code Synthesis Ltd
+// license   : MIT; see accompanying LICENSE file
+
+#ifndef BUTL_TIMESTAMP
+#define BUTL_TIMESTAMP
+
+#include <chrono>
+#include <string>
+#include <iosfwd>
+
+#include <butl/path>
+
+namespace butl
+{
+  // On all three main platforms that we target (GNU/Linux, Windows (both
+  // VC++ and GCC/MinGW64), and MacOS X) with recent C++ runtimes,
+  // system_clock has nanoseconds resolution and counts from the UNIX
+  // epoch. The latter is important since struct stat also returns times
+  // based on UNIX epoch.
+  //
+  // The underlying type for nanoseconds duration is signed integer type
+  // of at least 64 bits (currently int64_t). Because it is signed, we
+  // will overflow in year 2262 but by then the underlying type will
+  // most likely have changed to something larger than 64-bit.
+  //
+  // So to support other platforms that could possibly use a different
+  // system_clock resolutions (e.g., microseconds), we actually not going
+  // to assume anywhere (except perhaps timestamp.cxx) that we are dealing
+  // with nanoseconds or the 64-bit underlying type.
+  //
+  using std::chrono::system_clock;
+
+  using timestamp = system_clock::time_point;
+  using duration = system_clock::duration;
+
+  const timestamp timestamp_unknown {duration {-1}};
+  const timestamp timestamp_nonexistent {duration {0}};
+
+  std::ostream&
+  operator<< (std::ostream&, const timestamp&);
+
+  std::ostream&
+  operator<< (std::ostream&, const duration&);
+
+  // Returns timestamp_nonexistent if the entry at the specified path
+  // does not exist. All other errors are reported by throwing
+  // std::system_error.
+  //
+  timestamp
+  path_mtime (const path&);
+};
+
+#endif // BUTL_TIMESTAMP
-- 
cgit v1.1