include/tzfile.h

Go to the documentation of this file.

//
// C++ Interface: TZ file loader
//
// Description: internal interface to time zones
//
//
// Author: Konrad Rosenbaum <konrad@silmor.de>, (C) 2008
//
// Copyright: See README/COPYING files that come with this distribution
//
//


#ifndef TZFILE_H
#define TZFILE_H

#include <QStringList>

class QByteArray;
class QIODevice;


#if defined(TZ_LIBRARY_BUILD)
#  define TZLIB_EXPORT Q_DECL_EXPORT
#else
#  define TZLIB_EXPORT Q_DECL_IMPORT
#endif


namespace TimeZoneLib {

class TZLIB_EXPORT TZRule
{
        public:
                TZRule();
                TZRule(const TZRule&);
                
                TZRule& operator=(const TZRule&);
                
                qint64 startTime()const{return m_start;}
                qint64 endTime()const{return m_end;}
                QString abbreviation()const{return m_abbr;}
                bool isDST()const{return m_isdst;}
                qint32 offsetFromUTC()const{return m_off;}
                
                bool matches(qint64 ts)const{return m_start<=ts && m_end>ts;}
                
                bool matchesLocal(qint64 ts)const{return matches(ts-m_off);}
                
                bool operator<(const TZRule&r)const{return m_start<r.m_start;}
                bool operator<=(const TZRule&r)const{return m_start<=r.m_start;}
                
        private:
                friend class TZFile;
                friend class PosixRule;
                TZRule(qint64 start,qint32 off,QString abbr,bool isdst);
                void setEnd(qint64 e){m_end=e;}
                
                qint64 m_start,m_end;
                qint32 m_off;
                QString m_abbr;
                bool m_isdst;
};

class TZLIB_EXPORT PosixRule
{
        public:
                PosixRule();
                PosixRule(const PosixRule&);
                PosixRule(QString);
                
                PosixRule& operator=(const PosixRule&);
                
                QString asString()const{return m_str;}
                
                QList<TZRule> rulesForYear(int)const;
                
                TZRule nextRule(const TZRule&)const;
                
                TZRule ruleForTime(qint64)const;
                
                TZRule ruleForLocalTime(qint64)const;
                
                enum StartType{
                        StartNone,
                        StartDay0,
                        StartDay1,
                        StartWeek
                };
                
                QString standardName()const{return m_abbr;}
                
                QString daylightName()const{return m_abbrdst;}
                
                qint32 standardOffset()const{return m_off;}
                
                qint32 daylightOffset()const{return m_offdst;}
                
                bool haveDST()const{return m_abbr!=m_abbrdst;}
                
        private:
                
                QString m_str,m_abbr,m_abbrdst;
                qint32 m_off,m_offdst;
                StartType m_types,m_typee;
                qint32 m_months,m_weeks,m_days,m_times;
                qint32 m_monthe,m_weeke,m_daye,m_timee;
                
                TZRule createRule(qint32 year,bool start)const;
};

class TZLIB_EXPORT TZFile
{
        public:
                TZFile();
                TZFile(QString tz);
                TZFile(const char* tz);
                TZFile(QIODevice&);
                TZFile(const QByteArray&);
                TZFile(const TZFile&);
                TZFile(int offset);
                
                TZFile& operator=(const TZFile&);
                
                bool isValid()const{return m_valid;}
                
                QString name()const{return m_name;}
                
                void setName(QString n){m_name=n;}
                
                TZRule ruleForTime(qint64);
                
                TZRule ruleForLocalTime(qint64);
                
                QList<TZRule> fileRules()const{return m_file;}
                
                PosixRule posixRule()const{return m_posix;}
                
                QList<TZRule> cachedRules()const{return m_cache;}
                
                QString fileName()const{return m_fname;}
                
                QString dirName()const;
                
                QString version()const;
                
                static QString builtinVersion();
                
                static QString libraryVersion();
                
                static QStringList searchPath();
                static void setSearchPath(const QStringList&);
        private:
                void strConstruct(QString);
                bool load(const QByteArray&);
                int load(const QByteArray&,char);
                
                bool m_valid;
                QList<TZRule>m_file;
                QList<TZRule>m_cache;
                PosixRule m_posix;
                QString m_name,m_fname;
                
                static QStringList m_search;
};

//end of namespace
};

#endif