TimeSpec.h++

Go to the documentation of this file.

/* ---------------------------------------------------------------------------
   commonc++ - A C++ Common Class Library
   Copyright (C) 2005-2012  Mark A Lindner

   This file is part of commonc++.

   This library is free software; you can redistribute it and/or
   modify it under the terms of the GNU Library General Public
   License as published by the Free Software Foundation; either
   version 2 of the License, or (at your option) any later version.

   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
   Library General Public License for more details.

   You should have received a copy of the GNU Library General Public
   License along with this library; if not, write to the Free
   Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
   ---------------------------------------------------------------------------
*/

#ifndef __ccxx_TimeSpec_hxx
#define __ccxx_TimeSpec_hxx

#include <commonc++/Common.h++>
#include <commonc++/BitSet.h++>
#include <commonc++/DateTime.h++>
#include <commonc++/String.h++>

namespace ccxx {

class COMMONCPP_API TimeSpec
{
  public:

  TimeSpec() throw();

  TimeSpec(const DateTime& time) throw();

  TimeSpec(uint_t hour, uint_t minute) throw();

  TimeSpec(uint_t hour, uint_t minute, uint_t month, uint_t day) throw();

  TimeSpec(const String& spec);

  virtual ~TimeSpec() throw();

  void setSpec(const String& spec);

  TimeSpec& setMonth(uint_t month) throw();

  TimeSpec& setMonths(uint_t month1, uint_t month2) throw();

  TimeSpec& clearMonth(uint_t month) throw();

  TimeSpec& clearMonths(uint_t month1, uint_t month2) throw();

  TimeSpec& setAllMonths() throw();

  TimeSpec& clearAllMonths() throw();

  TimeSpec& setDay(uint_t day) throw();

  TimeSpec& setDays(uint_t day1, uint_t day2) throw();

  TimeSpec& clearDay(uint_t day) throw();

  TimeSpec& clearDays(uint_t day1, uint_t day2) throw();

  TimeSpec& setAllDays() throw();

  TimeSpec& clearAllDays() throw();

  TimeSpec& setDayOfWeek(uint_t dow) throw();

  TimeSpec& setDaysOfWeek(uint_t dow1, uint_t dow2) throw();

  TimeSpec& clearDayOfWeek(uint_t dow) throw();

  TimeSpec& clearDaysOfWeek(uint_t dow1, uint_t dow2) throw();

  TimeSpec& setAllDaysOfWeek() throw();

  TimeSpec& clearAllDaysOfWeek() throw();

  TimeSpec& setHour(uint_t hour) throw();

  TimeSpec& setHours(uint_t hour1, uint_t hour2) throw();

  TimeSpec& clearHour(uint_t hour) throw();

  TimeSpec& clearHours(uint_t hour1, uint_t hour2) throw();

  TimeSpec& setAllHours() throw();

  TimeSpec& clearAllHours() throw();

  TimeSpec& setMinute(uint_t minute) throw();

  TimeSpec& setMinutes(uint_t minute1, uint_t minute2) throw();

  TimeSpec& clearMinute(uint_t minute) throw();

  TimeSpec& clearMinutes(uint_t minute1, uint_t minute2) throw();

  TimeSpec& setAllMinutes() throw();

  TimeSpec& clearAllMinutes() throw();

  bool matches(time_s_t time) const throw();

  bool matches(time_ms_t time) const throw();

  bool matches(uint_t month, uint_t day, uint_t weekday, uint_t hour,
               uint_t minute) const throw();

  String toString() const;

  private:

  void _parseValues(String str, uint_t base, BitSet& set) throw();
  void _set(BitSet& bset, uint_t base, uint_t pos, bool set) throw();
  void _setRange(BitSet& bset, uint_t base, uint_t min, uint_t max,
                 bool set) throw();
  void _format(const BitSet& set, uint_t base, String& s) const;

  BitSet _months;
  BitSet _days;
  BitSet _dow;
  BitSet _hours;
  BitSet _minutes;
};

}; // namespace ccxx

#endif // __ccxx_TimeSpec_hxx

/* end of header file */