/** * @file llunit.h * @brief Unit conversion classes * * $LicenseInfo:firstyear=2001&license=viewerlgpl$ * Second Life Viewer Source Code * Copyright (C) 2012, Linden Research, Inc. * * This library is free software; you can redistribute it and/or * modify it under the terms of the GNU Lesser General Public * License as published by the Free Software Foundation; * version 2.1 of the License only. * * This library is distributed in the hope that it will be useful, * but WITHOUT ANY WARRANTY; without even the implied warranty of * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU * Lesser General Public License for more details. * * You should have received a copy of the GNU Lesser General Public * License along with this library; if not, write to the Free Software * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA * * Linden Research, Inc., 945 Battery Street, San Francisco, CA 94111 USA * $/LicenseInfo$ */ #ifndef LL_LLUNIT_H #define LL_LLUNIT_H #include "stdtypes.h" #include "llpreprocessor.h" namespace LLUnits { template struct HighestPrecisionType { typedef T type_t; }; template<> struct HighestPrecisionType { typedef F64 type_t; }; template<> struct HighestPrecisionType { typedef S64 type_t; }; template<> struct HighestPrecisionType { typedef S64 type_t; }; template<> struct HighestPrecisionType { typedef S64 type_t; }; template<> struct HighestPrecisionType { typedef S64 type_t; }; template<> struct HighestPrecisionType { typedef S64 type_t; }; template<> struct HighestPrecisionType { typedef S64 type_t; }; template struct ConversionFactor { static typename HighestPrecisionType::type_t get() { // spurious use of dependent type to stop gcc from triggering the static assertion before instantiating the template llstatic_assert(sizeof(DERIVED_UNITS_TAG) == 0, "Cannot convert between types."); } }; template struct ConversionFactor { static typename HighestPrecisionType::type_t get() { return 1; } }; } template struct LLUnit { typedef LLUnit self_t; typedef STORAGE_TYPE storage_t; LLUnit(storage_t value = storage_t()) : mValue(value) {} template LLUnit(LLUnit other) : mValue(convert(other)) {} LLUnit(self_t& other) : mValue(other.mValue) {} self_t& operator = (storage_t value) { mValue = value; return *this; } template self_t& operator = (LLUnit other) { mValue = convert(other); return *this; } operator storage_t() const { return value(); } storage_t value() const { return mValue; } template LLUnit as() { return LLUnit(*this); } void operator += (storage_t value) { mValue += value; } template void operator += (LLUnit other) { mValue += convert(other); } void operator -= (storage_t value) { mValue -= value; } template void operator -= (LLUnit other) { mValue -= convert(other); } void operator *= (storage_t multiplicand) { mValue *= multiplicand; } template void operator *= (LLUnit multiplicand) { // spurious use of dependent type to stop gcc from triggering the static assertion before instantiating the template llstatic_assert(sizeof(OTHER_UNIT) == 0, "Multiplication of unit types not supported."); } void operator /= (storage_t divisor) { mValue /= divisor; } template void operator /= (LLUnit divisor) { // spurious use of dependent type to stop gcc from triggering the static assertion before instantiating the template llstatic_assert(sizeof(OTHER_UNIT) == 0, "Division of unit types not supported."); } template static storage_t convert(LLUnit v) { return (storage_t)(v.value() * LLUnits::ConversionFactor::get() * LLUnits::ConversionFactor::get()); } protected: storage_t mValue; }; template struct LLUnitStrict : public LLUnit { typedef LLUnitStrict self_t; typedef typename LLUnit::storage_t storage_t; explicit LLUnitStrict(storage_t value = storage_t()) : LLUnit(value) {} template LLUnitStrict(LLUnit other) : LLUnit(convert(other)) {} LLUnitStrict(self_t& other) : LLUnit(other) {} private: operator storage_t() const { return LLUnit::value(); } }; // // operator + // template LLUnit operator + (LLUnit first, LLUnit second) { LLUnit result(first); result += second; return result; } template LLUnit operator + (LLUnit first, SCALAR_TYPE second) { LLUnit result(first); result += second; return result; } template LLUnit operator + (SCALAR_TYPE first, LLUnit second) { LLUnit result(first); result += second; return result; } // // operator - // template LLUnit operator - (LLUnit first, LLUnit second) { LLUnit result(first); result -= second; return result; } template LLUnit operator - (LLUnit first, SCALAR_TYPE second) { LLUnit result(first); result -= second; return result; } template LLUnit operator - (SCALAR_TYPE first, LLUnit second) { LLUnit result(first); result -= second; return result; } // // operator * // template LLUnit operator * (SCALAR_TYPE first, LLUnit second) { return LLUnit(first * second.value()); } template LLUnit operator * (LLUnit first, SCALAR_TYPE second) { return LLUnit(first.value() * second); } template LLUnit operator * (LLUnit, LLUnit) { // spurious use of dependent type to stop gcc from triggering the static assertion before instantiating the template llstatic_assert(sizeof(STORAGE_TYPE1) == 0, "Multiplication of unit types results in new unit type - not supported."); return LLUnit(); } // // operator / // template SCALAR_TYPE operator / (SCALAR_TYPE first, LLUnit second) { return SCALAR_TYPE(first / second.value()); } template LLUnit operator / (LLUnit first, SCALAR_TYPE second) { return LLUnit(first.value() / second); } template STORAGE_TYPE1 operator / (LLUnit first, LLUnit second) { // spurious use of dependent type to stop gcc from triggering the static assertion before instantiating the template return STORAGE_TYPE1(first.value() / second.value()); } #define COMPARISON_OPERATORS(op) \ template \ bool operator op (SCALAR_TYPE first, LLUnit second) \ { \ return first op second.value(); \ } \ \ template \ bool operator op (LLUnit first, SCALAR_TYPE second) \ { \ return first.value() op second; \ } \ \ template \ bool operator op (LLUnit first, LLUnit second) \ { \ return first.value() op first.convert(second); \ } COMPARISON_OPERATORS(<) COMPARISON_OPERATORS(<=) COMPARISON_OPERATORS(>) COMPARISON_OPERATORS(>=) COMPARISON_OPERATORS(==) COMPARISON_OPERATORS(!=) namespace LLUnits { template struct HighestPrecisionType > { typedef typename HighestPrecisionType::type_t type_t; }; #define LL_DECLARE_DERIVED_UNIT(base_unit_name, unit_name, conversion_factor) \ struct unit_name \ { \ typedef base_unit_name base_unit_t; \ }; \ template \ struct ConversionFactor \ { \ static typename HighestPrecisionType::type_t get() \ { \ return typename HighestPrecisionType::type_t(conversion_factor); \ } \ }; \ \ template \ struct ConversionFactor \ { \ static typename HighestPrecisionType::type_t get() \ { \ return typename HighestPrecisionType::type_t(1.0 / (conversion_factor)); \ } \ } struct Bytes { typedef Bytes base_unit_t; }; LL_DECLARE_DERIVED_UNIT(Bytes, Kilobytes, 1024); LL_DECLARE_DERIVED_UNIT(Bytes, Megabytes, 1024 * 1024); LL_DECLARE_DERIVED_UNIT(Bytes, Gigabytes, 1024 * 1024 * 1024); LL_DECLARE_DERIVED_UNIT(Bytes, Bits, (1.0 / 8.0)); LL_DECLARE_DERIVED_UNIT(Bytes, Kilobits, (1024 / 8)); LL_DECLARE_DERIVED_UNIT(Bytes, Megabits, (1024 / 8)); LL_DECLARE_DERIVED_UNIT(Bytes, Gigabits, (1024 * 1024 * 1024 / 8)); struct Seconds { typedef Seconds base_unit_t; }; LL_DECLARE_DERIVED_UNIT(Seconds, Minutes, 60); LL_DECLARE_DERIVED_UNIT(Seconds, Hours, 60 * 60); LL_DECLARE_DERIVED_UNIT(Seconds, Milliseconds, (1.0 / 1000.0)); LL_DECLARE_DERIVED_UNIT(Seconds, Microseconds, (1.0 / (1000000.0))); LL_DECLARE_DERIVED_UNIT(Seconds, Nanoseconds, (1.0 / (1000000000.0))); struct Meters { typedef Meters base_unit_t; }; LL_DECLARE_DERIVED_UNIT(Meters, Kilometers, 1000); LL_DECLARE_DERIVED_UNIT(Meters, Centimeters, (1.0 / 100.0)); LL_DECLARE_DERIVED_UNIT(Meters, Millimeters, (1.0 / 1000.0)); struct Hertz { typedef Hertz base_unit_t; }; LL_DECLARE_DERIVED_UNIT(Hertz, Kilohertz, 1000); LL_DECLARE_DERIVED_UNIT(Hertz, Megahertz, 1000 * 1000); LL_DECLARE_DERIVED_UNIT(Hertz, Gigahertz, 1000 * 1000 * 1000); } #endif // LL_LLUNIT_H