CommonTime.hpp

Go to the documentation of this file.

#pragma ident "$Id: CommonTime.hpp 1162 2008-03-27 21:18:13Z snelsen $"



#ifndef GPSTK_COMMONTIME_HPP
#define GPSTK_COMMONTIME_HPP

//============================================================================
//
//  This file is part of GPSTk, the GPS Toolkit.
//
//  The GPSTk 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; either version 2.1 of the License, or
//  any later version.
//
//  The GPSTk 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 GPSTk; if not, write to the Free Software Foundation,
//  Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
//  
//  Copyright 2004, The University of Texas at Austin
//
//============================================================================

#include "Exception.hpp"

namespace gpstk
{
   class CommonTime
   {
     public:


      static const long BEGIN_LIMIT_JDAY;
      static const long END_LIMIT_JDAY;
      static const CommonTime BEGINNING_OF_TIME;
      static const CommonTime END_OF_TIME;
  

      CommonTime( long day = 0, 
                  long sod = 0,
                  double fsod = 0.0 )
         throw( gpstk::InvalidParameter )
      { set( day, sod, fsod ); }

      CommonTime( long day,
                  double sod )
         throw( gpstk::InvalidParameter )
      { set( day, sod ); }
      
      CommonTime( double day )
         throw( gpstk::InvalidParameter )
      { set( day ); }
      
      CommonTime( const CommonTime& right )
         throw();

      CommonTime& operator=( const CommonTime& right )
         throw();
      
      virtual ~CommonTime()
         throw()
      {}

      CommonTime& set( long day, 
                       long sod,
                       double fsod = 0.0 )
         throw( gpstk::InvalidParameter );

      CommonTime& set( long day,
                       double sod = 0.0 )
         throw( gpstk::InvalidParameter );
      
      CommonTime& set( double day )
         throw( gpstk::InvalidParameter );

      CommonTime& setInternal( long day = 0,
                               long msod = 0,
                               double fsod = 0.0 )
         throw( gpstk::InvalidParameter );

      void get( long& day, 
                long& sod,
                double& fsod ) const
         throw();

      void get( long& day,
                double& sod ) const
         throw();
      
      void get( double& day ) const
         throw();
      
      void getInternal( long& day,
                        long& msod,
                        double& fsod ) const
         throw()
      { day = m_day; msod = m_msod; fsod = m_fsod; }

      double getDays() const 
         throw();

      double getSecondOfDay() const
         throw();

      
      double operator-( const CommonTime& right ) const
         throw();
      
      CommonTime operator+( double seconds ) const
         throw( InvalidRequest );
      
      CommonTime operator-( double seconds ) const
         throw( InvalidRequest );
      
      CommonTime& operator+=( double seconds )
         throw( InvalidRequest );
      
      CommonTime& operator-=( double seconds )
         throw( InvalidRequest );
      
      CommonTime& addSeconds( double seconds )
         throw( InvalidRequest );

      CommonTime& addDays( long days )
         throw( InvalidRequest );
      
      CommonTime& addSeconds( long seconds )
         throw( InvalidRequest );
      
      CommonTime& addMilliseconds( long ms )
         throw( InvalidRequest );

      bool operator==( const CommonTime& right ) const
         throw();
      bool operator!=( const CommonTime& right ) const
         throw();
      bool operator<( const CommonTime& right ) const
         throw();
      bool operator>( const CommonTime& right ) const
         throw();
      bool operator<=( const CommonTime& right ) const
         throw();
      bool operator>=( const CommonTime& right ) const
         throw();

      void reset()
         throw()
      { m_day = m_msod = 0; m_fsod = 0.0; }

      std::string asString() const
         throw();

   protected:
      
      bool add( long days,
                long msod,
                double fsod )
         throw();
      
      bool normalize()
         throw();
      
      long m_day;     //< days (as a Julian Day)     0 <= val < 2^31
      long m_msod;    //< milliseconds-of-day        0 <= val < 86400000
      double m_fsod;  //< fractional seconds-of-day  0 <= val < 0.001
   };

   std::ostream& operator<<(std::ostream& o, const CommonTime& ct);

} // namespace

#endif // GPSTK_COMMONTIME_HPP

---