Magic_Game/Kiwano/base/time.h

// Copyright (c) 2016-2018 Kiwano - Nomango
// 
// Permission is hereby granted, free of charge, to any person obtaining a copy
// of this software and associated documentation files (the "Software"), to deal
// in the Software without restriction, including without limitation the rights
// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
// copies of the Software, and to permit persons to whom the Software is
// furnished to do so, subject to the following conditions:
// 
// The above copyright notice and this permission notice shall be included in
// all copies or substantial portions of the Software.
// 
// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
// THE SOFTWARE.

#pragma once
#include "../macros.h"
#include "../common/String.h"
#include <ostream>
#include <istream>

namespace kiwano
{
	namespace time
	{
		// ʱ<><CAB1><EFBFBD><EFBFBD>
		//
		// ʱ<><CAB1><EFBFBD>α<EFBFBD>ʾ<EFBFBD><CABE>:
		//     5 <20><>: time::Sec * 5
		//     1.5 Сʱ: time::Hour * 1.5
		//     3 Сʱ 45 <20><> 15 <20><>: time::Hour * 3 + time::Min * 45 + time::Sec * 15
		// <20><> VS2015 <20><><EFBFBD><EFBFBD><EFBFBD>߰汾<DFB0><E6B1BE><EFBFBD><EFBFBD>ʹ<EFBFBD><CAB9> time literals:
		//     5 <20><>: 5_s
		//     1.5 Сʱ: 1.5_h
		//     3 Сʱ 45 <20><> 15 <20><>: 3_h + 45_m + 15_s
		//
		struct KGE_API Duration
		{
			Duration();

			Duration(
				long milliseconds
			);

			// ת<><D7AA>Ϊ<EFBFBD><CEAA><EFBFBD><EFBFBD>
			inline long Milliseconds() const { return milliseconds_; }

			// ת<><D7AA>Ϊ<EFBFBD><CEAA>
			float Seconds() const;

			// ת<><D7AA>Ϊ<EFBFBD><CEAA><EFBFBD><EFBFBD>
			float Minutes() const;

			// ת<><D7AA>ΪСʱ
			float Hours() const;

			// ʱ<><CAB1><EFBFBD>Ƿ<EFBFBD><C7B7><EFBFBD><EFBFBD><EFBFBD>
			inline bool IsZero() const { return milliseconds_ == 0LL; }

			// תΪ<D7AA>ַ<EFBFBD><D6B7><EFBFBD>
			String ToString() const;

			inline operator bool() const { return !IsZero(); }

			bool operator== (const Duration &) const;
			bool operator!= (const Duration &) const;
			bool operator> (const Duration &) const;
			bool operator>= (const Duration &) const;
			bool operator< (const Duration &) const;
			bool operator<= (const Duration &) const;

			float operator / (const Duration &) const;

			const Duration operator + (const Duration &) const;
			const Duration operator - (const Duration &) const;
			const Duration operator - () const;
			const Duration operator * (int) const;
			const Duration operator * (unsigned long long) const;
			const Duration operator * (float) const;
			const Duration operator * (double) const;
			const Duration operator * (long double) const;
			const Duration operator / (int) const;
			const Duration operator / (float) const;
			const Duration operator / (double) const;

			Duration& operator += (const Duration &);
			Duration& operator -= (const Duration &);
			Duration& operator *= (int);
			Duration& operator *= (float);
			Duration& operator *= (double);
			Duration& operator /= (int);
			Duration& operator /= (float);
			Duration& operator /= (double);

			friend const Duration operator* (int, const Duration &);
			friend const Duration operator* (float, const Duration &);
			friend const Duration operator* (double, const Duration &);
			friend const Duration operator* (long double, const Duration &);
			friend const Duration operator/ (int, const Duration &);
			friend const Duration operator/ (float, const Duration &);
			friend const Duration operator/ (double, const Duration &);

		public:
			// ʱ<><CAB1><EFBFBD>θ<EFBFBD>ʽ<EFBFBD><CABD>
			//
			// ʱ<><CAB1><EFBFBD><EFBFBD><EFBFBD>ַ<EFBFBD><D6B7><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>з<EFBFBD><D0B7>ŵĸ<C5B5><C4B8><EFBFBD><EFBFBD><EFBFBD>, <20><><EFBFBD>Ҵ<EFBFBD><D2B4><EFBFBD>ʱ<EFBFBD>䵥λ<E4B5A5><CEBB>׺
			// <20><><EFBFBD><EFBFBD>: "300ms", "-1.5h", "2h45m"
			// <20><><EFBFBD><EFBFBD><EFBFBD><EFBFBD>ʱ<EFBFBD>䵥λ<E4B5A5><CEBB> "ms", "s", "m", "h"
			static Duration Parse(const String& parse_str);

			template <typename _Char>
			friend inline std::basic_ostream<_Char>& operator<<(std::basic_ostream<_Char>& out, const Duration& dur)
			{
				return out << dur.ToString();
			}

			template <typename _Char>
			friend inline std::basic_istream<_Char>& operator>>(std::basic_istream<_Char>& in, Duration& dur)
			{
				String str;
				if (in >> str)
				{
					dur = Duration::Parse(str);
				}
				return in;
			}

		private:
			long milliseconds_;
		};

		/* Ԥ<><D4A4><EFBFBD><EFBFBD><EFBFBD><EFBFBD>ʱ<EFBFBD><CAB1><EFBFBD><EFBFBD> */
		KGE_API extern const Duration Ms;		// <20><><EFBFBD><EFBFBD>
		KGE_API extern const Duration Sec;		// <20><>
		KGE_API extern const Duration Min;		// <20><><EFBFBD><EFBFBD>
		KGE_API extern const Duration Hour;		// Сʱ


		// ʱ<><CAB1>
		//
		// <20><>ȡ<EFBFBD><C8A1>ǰʱ<C7B0><CAB1>: Time now = Time::Now();
		// <20><>ʱ<EFBFBD><CAB1><EFBFBD><EFBFBD><EFBFBD><EFBFBD>, <20>õ<EFBFBD>һ<EFBFBD><D2BB> Duration <20><><EFBFBD><EFBFBD>, <20><><EFBFBD><EFBFBD>:
		//     Time t1, t2;
		//     int ms = (t2 - t1).Milliseconds();  // <20><>ȡ<EFBFBD><C8A1>ʱ<EFBFBD><CAB1><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>ĺ<EFBFBD><C4BA><EFBFBD><EFBFBD><EFBFBD>
		// 
		struct KGE_API Time
		{
			Time();

			Time(long);

			// <20>Ƿ<EFBFBD><C7B7><EFBFBD><EFBFBD><EFBFBD>ʱ
			inline bool IsZero() const { return dur_ == 0; }

			const Time operator + (const Duration &) const;
			const Time operator - (const Duration &) const;

			Time& operator += (const Duration &);
			Time& operator -= (const Duration &);

			const Duration operator - (const Time &) const;

		public:
			// <20><>ȡ<EFBFBD><C8A1>ǰʱ<C7B0><CAB1>
			// <20><><EFBFBD>ڸ<EFBFBD>ʱ<EFBFBD><CAB1><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>ϵͳ<CFB5><CDB3><EFBFBD><EFBFBD>ʱ<EFBFBD>俪ʼ<E4BFAA><CABC><EFBFBD><EFBFBD>, <20><><EFBFBD><EFBFBD><EFBFBD>޷<EFBFBD><DEB7><EFBFBD>ʽ<EFBFBD><CABD><EFBFBD><EFBFBD>ʱ<EFBFBD><CAB1>, 
			// Ҳ<>޷<EFBFBD><DEB7><EFBFBD><EFBFBD>ø<EFBFBD>ʱ<EFBFBD><CAB1><EFBFBD><EFBFBD> Unix ʱ<><CAB1><EFBFBD><EFBFBD>
			static Time Now() KGE_NOEXCEPT;

		private:
			long dur_;
		};
	}
}

namespace kiwano
{
	using namespace time;
}

#if VS_VER >= VS_2015

namespace kiwano
{
	inline namespace literals
	{
		inline const kiwano::time::Duration operator "" _ms(long double val)
		{
			return kiwano::time::Ms * val;
		}

		inline const kiwano::time::Duration operator "" _s(long double val)
		{
			return kiwano::time::Sec * val;
		}

		inline const kiwano::time::Duration operator "" _m(long double val)
		{
			return kiwano::time::Min * val;
		}

		inline const kiwano::time::Duration operator "" _h(long double val)
		{
			return kiwano::time::Hour * val;
		}

		inline const kiwano::time::Duration operator "" _ms(unsigned long long val)
		{
			return kiwano::time::Ms * val;
		}

		inline const kiwano::time::Duration operator "" _s(unsigned long long val)
		{
			return kiwano::time::Sec * val;
		}

		inline const kiwano::time::Duration operator "" _m(unsigned long long val)
		{
			return kiwano::time::Min * val;
		}

		inline const kiwano::time::Duration operator "" _h(unsigned long long val)
		{
			return kiwano::time::Hour * val;
		}
	}

	namespace time
	{
		using namespace kiwano::literals;
	}
}

#endif