/********************************************************************* * Software License Agreement (BSD License) * * Copyright (c) 2008, Willow Garage, Inc. * All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions * are met: * * * Redistributions of source code must retain the above copyright * notice, this list of conditions and the following disclaimer. * * Redistributions in binary form must reproduce the above * copyright notice, this list of conditions and the following * disclaimer in the documentation and/or other materials provided * with the distribution. * * Neither the name of Willow Garage, Inc. nor the names of its * contributors may be used to endorse or promote products derived * from this software without specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS * FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE * COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, * BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN * ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE * POSSIBILITY OF SUCH DAMAGE. *********************************************************************/ #ifndef ROBOT_DURATION_H #define ROBOT_DURATION_H /********************************************************************* ** Pragmas *********************************************************************/ #ifdef _MSC_VER // Robot_time has some magic interface that doesn't directly include // its implementation, this just disbales those warnings. #pragma warning(disable: 4244) #pragma warning(disable: 4661) #endif #include #include #include #include #include #include "robot_time_decl.h" namespace robot { ROBOT_TIME_DECL void normalizeSecNSecSigned(int64_t& sec, int64_t& nsec); ROBOT_TIME_DECL void normalizeSecNSecSigned(int32_t& sec, int32_t& nsec); /** * \brief Base class for Duration implementations. Provides storage, common functions and operator overloads. * This should not need to be used directly. */ template class DurationBase { public: int32_t sec, nsec; DurationBase() : sec(0), nsec(0) { } DurationBase(int32_t _sec, int32_t _nsec); explicit DurationBase(double t){fromSec(t);}; T operator+(const T &rhs) const; T operator-(const T &rhs) const; T operator-() const; T operator*(double scale) const; T& operator+=(const T &rhs); T& operator-=(const T &rhs); T& operator*=(double scale); bool operator==(const T &rhs) const; inline bool operator!=(const T &rhs) const { return !(*static_cast(this) == rhs); } bool operator>(const T &rhs) const; bool operator<(const T &rhs) const; bool operator>=(const T &rhs) const; bool operator<=(const T &rhs) const; double toSec() const { return static_cast(sec) + 1e-9*static_cast(nsec); }; int64_t toNSec() const {return static_cast(sec)*1000000000ll + static_cast(nsec); }; T& fromSec(double t); T& fromNSec(int64_t t); bool isZero() const; // boost::posix_time conversion removed in std-only build static const T MIN; //!< Minimum representable duration (negative) static const T MAX; //!< Maximum representable duration static const T ZERO; //!< Zero duration static const T DAY; //!< One day duration static const T HOUR; //!< One hour duration static const T MINUTE; //!< One minute duration static const T SECOND; //!< One second duration static const T MILLISECOND; //!< One millisecond duration static const T MICROSECOND; //!< One microsecond duration static const T NANOSECOND; //!< One nanosecond duration }; class Rate; /** * \brief Duration representation for use with the Time class. * * robot::DurationBase provides most of its functionality. */ class ROBOT_TIME_DECL Duration : public DurationBase { public: Duration() : DurationBase() { } Duration(int32_t _sec, int32_t _nsec) : DurationBase(_sec, _nsec) {} explicit Duration(double t) { fromSec(t); } explicit Duration(const Rate&); /** * \brief sleep for the amount of time specified by this Duration. If a signal interrupts the sleep, resleeps for the time remaining. * @return True if the desired sleep duration was met, false otherwise. */ bool sleep() const; }; extern ROBOT_TIME_DECL const Duration DURATION_MAX; extern ROBOT_TIME_DECL const Duration DURATION_MIN; template<> const Duration DurationBase::MAX; template<> const Duration DurationBase::MIN; template<> const Duration DurationBase::ZERO; template<> const Duration DurationBase::DAY; template<> const Duration DurationBase::HOUR; template<> const Duration DurationBase::MINUTE; template<> const Duration DurationBase::SECOND; template<> const Duration DurationBase::MILLISECOND; template<> const Duration DurationBase::MICROSECOND; template<> const Duration DurationBase::NANOSECOND; /** * \brief Duration representation for use with the WallTime class. * * robot::DurationBase provides most of its functionality. */ class ROBOT_TIME_DECL WallDuration : public DurationBase { public: WallDuration() : DurationBase() { } WallDuration(int32_t _sec, int32_t _nsec) : DurationBase(_sec, _nsec) {} explicit WallDuration(double t) { fromSec(t); } explicit WallDuration(const Rate&); /** * \brief sleep for the amount of time specified by this Duration. If a signal interrupts the sleep, resleeps for the time remaining. * @return True if the desired sleep duration was met, false otherwise. */ bool sleep() const; }; template<> const WallDuration DurationBase::MAX; template<> const WallDuration DurationBase::MIN; template<> const WallDuration DurationBase::ZERO; template<> const WallDuration DurationBase::DAY; template<> const WallDuration DurationBase::HOUR; template<> const WallDuration DurationBase::MINUTE; template<> const WallDuration DurationBase::SECOND; template<> const WallDuration DurationBase::MILLISECOND; template<> const WallDuration DurationBase::MICROSECOND; template<> const WallDuration DurationBase::NANOSECOND; ROBOT_TIME_DECL std::ostream &operator <<(std::ostream &os, const Duration &rhs); ROBOT_TIME_DECL std::ostream &operator <<(std::ostream &os, const WallDuration &rhs); } #endif // ROBOT_DURATION_H