kmime_util.h

/*
    kmime_util.h
 
    KMime, the KDE internet mail/usenet news message library.
    Copyright (c) 2001 the KMime authors.
    See file AUTHORS for details
 
    This program is free software; you can redistribute it and/or modify
    it under the terms of the GNU General Public License as published by
    the Free Software Foundation; either version 2 of the License, or
    (at your option) any later version.
    You should have received a copy of the GNU General Public License
    along with this program; if not, write to the Free Software Foundation,
    Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, US
*/
#ifndef __KMIME_UTIL_H__
#define __KMIME_UTIL_H__
 
#include "tqdatetime.h"
#include "tqstring.h"
#include "tqcstring.h"
#include "tqvaluelist.h"
#include "time.h"
#include <tdemacros.h>
 
typedef TQValueList<TQCString> QCStringList;
 
namespace KMime {

  extern const char* cachedCharset(const TQCString &name) TDE_EXPORT;

  extern const char* cachedLanguage(const TQCString &name) TDE_EXPORT;

  extern bool isUsAscii(const TQString &s) TDE_EXPORT;
 
  inline bool isOfSet(const uchar map[16], unsigned char ch) {
    Q_ASSERT( ch < 128 );
    return ( map[ ch/8 ] & 0x80 >> ch%8 );
  }
 
  extern const uchar specialsMap[16];
  extern const uchar tSpecialsMap[16];
  extern const uchar aTextMap[16];
  extern const uchar tTextMap[16];
  extern const uchar eTextMap[16];
 
  inline bool isSpecial(char ch) {
    return isOfSet( specialsMap, ch );
  }
  inline bool isTSpecial(char ch) {
    return isOfSet( tSpecialsMap, ch );
  }
  inline bool isAText(char ch) {
    return isOfSet( aTextMap, ch );
  }
  inline bool isTText(char ch) {
    return isOfSet( tTextMap, ch );
  }
  inline bool isEText(char ch) {
    return isOfSet( eTextMap, ch );
  }

  extern TQString decodeRFC2047String(const TQCString &src, const char **usedCS,
                     const TQCString &defaultCS, bool forceCS) TDE_EXPORT;

  extern TQString decodeRFC2047String(const TQCString &src) TDE_EXPORT;

  extern TQCString encodeRFC2047String(const TQString &src, const char *charset,
                      bool addressHeader=false, bool allow8bitHeaders=false) TDE_EXPORT;

  extern TQCString uniqueString() TDE_EXPORT;

  extern TQCString multiPartBoundary() TDE_EXPORT;

  extern TQCString extractHeader(const TQCString &src, const char *name) TDE_EXPORT;
  extern TQCString CRLFtoLF(const TQCString &s) TDE_EXPORT;
  extern TQCString CRLFtoLF(const char *s) TDE_EXPORT;
  extern TQCString LFtoCRLF(const TQCString &s) TDE_EXPORT;

  TDE_EXPORT extern void removeQuots(TQCString &str);
  TDE_EXPORT extern void removeQuots(TQString &str);
  TDE_EXPORT extern void addQuotes(TQCString &str, bool forceQuotes);
 

  class TDE_EXPORT DateFormatter {
  public:
    enum FormatType {
      CTime,      //< ctime "Sun Mar 31 02:08:35 2002"
      Localized,  //< localized "2002-03-31 02:08"
      Fancy,      //< fancy "Today 02:08:35"
      Iso,        //< iso  "2002-03-31 02:08:35"
      Custom      //< custom "whatever you like"
    };

    DateFormatter(FormatType fType = DateFormatter::Fancy);
 
    ~DateFormatter();

    FormatType getFormat() const;
    void setFormat(FormatType t);

    TQString dateString(time_t otime, const TQString& lang = TQString(),
               bool shortFormat = true, bool includeSecs=false) const;
    TQString dateString(const TQDateTime& dtime, const TQString& lang = TQString(),
               bool shortFormat = true, bool includeSecs=false) const;
 

    void    setCustomFormat(const TQString& format);
    TQString getCustomFormat() const;

    TQCString rfc2822(time_t otime) const;
    void reset();
 
    //statics
    static TQString  formatDate( DateFormatter::FormatType t, time_t time,
                const TQString& data = TQString(),
                bool shortFormat = true, bool includeSecs=false);

    static TQString  formatCurrentDate( DateFormatter::FormatType t,
                       const TQString& data = TQString(),
                       bool shortFormat = true, bool includeSecs=false);

    static TQCString rfc2822FormatDate( time_t time );
    static bool     isDaylight();
  protected:
    TQString fancy(time_t otime) const ;
    TQString localized(time_t otime, bool shortFormat = true, bool includeSecs = false,
              const TQString& localeLanguage=TQString() ) const;
    TQString cTime(time_t otime) const;
    TQString isoDate(time_t otime) const;

    TQString custom(time_t t) const;
    TQCString zone(time_t otime) const;
 
    time_t qdateToTimeT(const TQDateTime& dt) const;
  private:
    FormatType      mFormat;
    mutable time_t  mCurrentTime;
    mutable TQDateTime  mDate;
    TQString        mCustomFormat;
    static int          mDaylight;
  };
 
} // namespace KMime
 
#endif /* __KMIME_UTIL_H__ */