/*
kmime_header_parsing.h
This file is part of KMime, the KDE internet mail/usenet news message library.
Copyright (c) 2001-2002 Marc Mutz <mutz@kde.org>
KMime is free software; you can redistribute it and/or modify it
under the terms of the GNU General Public License, version 2, as
published by the Free Software Foundation.
KMime 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
General Public License for more details.
You should have received a copy of the GNU General Public License
along with this library; if not, write to the Free Software
Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
In addition, as a special exception, the copyright holders give
permission to link the code of this library with any edition of
the TQt library by Trolltech AS, Norway (or with modified versions
of TQt that use the same license as TQt), and distribute linked
combinations including the two. You must obey the GNU General
Public License in all respects for all of the code used other than
TQt. If you modify this file, you may extend this exception to
your version of the file, but you are not obligated to do so. If
you do not wish to do so, delete this exception statement from
your version.
*/
#ifndef __KMIME_HEADER_PARSING_H__
#define __KMIME_HEADER_PARSING_H__
#include <tqstring.h>
#include <tqpair.h>
#include <tqvaluelist.h>
#include <time.h>
#include <tdemacros.h>
template <typename K, typename V> class TQMap;
class TQStringList;
namespace KMime {
namespace Types {
// for when we can't make up our mind what to use...
struct TDE_EXPORT TQStringOrTQPair {
TQStringOrTQPair() : qstring(), qpair(0,0) {}
TQString qstring;
TQPair<const char*,int> qpair;
};
struct TDE_EXPORT AddrSpec {
TQString asString() const;
TQString localPart;
TQString domain;
};
typedef TQValueList<AddrSpec> AddrSpecList;
struct TDE_EXPORT Mailbox {
TQString displayName;
AddrSpec addrSpec;
};
typedef TQValueList<Mailbox> MailboxList;
struct TDE_EXPORT Address {
TQString displayName;
MailboxList mailboxList;
};
typedef TQValueList<Address> AddressList;
struct TDE_EXPORT DateTime {
time_t time; // secs since 1.1.1970, 0:00 UTC/GMT
long int secsEastOfGMT; // timezone
bool timeZoneKnown; // do we know the timezone? (e.g. on -0000)
};
} // namespace KMime::Types
namespace HeaderParsing {
/** Parse the encoded word in @p str pointed to by @p pos
(actually, @p pos-2, see below).
@param str the source string
@param pos in: the starting position (must already point to the
character following the initial '=?';
out: the new postion
@param ok only out: if true, the encoded-word was correct up
to and including the encoding specifier. The
encoded-text is quite generously parsed and @p ok
is still set to @p true when e.g. the encoded-word
appears to be truncated or contains whitespace.
@return the decoded string the encoded word represented.
*/
bool parseEncodedWord( const char* & scursor, const char * const send,
TQString & result, TQCString & language ) TDE_EXPORT;
//
// The parsing squad:
//
/** You may or may not have already started parsing into the
atom. This function will go on where you left off. */
bool parseAtom( const char* & scursor, const char * const send,
TQString & result, bool allow8Bit=false ) TDE_EXPORT;
bool parseAtom( const char* & scursor, const char * const send,
TQPair<const char*,int> & result, bool allow8Bit=false ) TDE_EXPORT;
/** You may or may not have already started parsing into the
token. This function will go on where you left off. */
bool parseToken( const char* & scursor, const char * const send,
TQString & result, bool allow8Bit=false ) TDE_EXPORT;
bool parseToken( const char* & scursor, const char * const send,
TQPair<const char*,int> & result, bool allow8Bit=false ) TDE_EXPORT;
/** @p scursor must be positioned after the opening openChar. */
bool parseGenericQuotedString( const char* & scursor, const char* const send,
TQString & result, bool isCRLF,
const char openChar='"',
const char closeChar='"' ) TDE_EXPORT;
/** @p scursor must be positioned right after the opening '(' */
bool parseComment( const char* & scursor, const char * const send,
TQString & result, bool isCRLF=false, bool reallySave=true ) TDE_EXPORT;
/** You may or may not have already started parsing into the phrase,
but only if it starts with atext. If you setup this function to
parse a phrase starting with an encoded-word or quoted-string,
@p scursor has to point to the char introducing the encoded-word
or quoted-string, resp. */
bool parsePhrase( const char* & scursor, const char * const send,
TQString & result, bool isCRLF=false ) TDE_EXPORT;
/** You may or may not have already started parsing into the initial
atom, but not up to it's end. */
bool parseDotAtom( const char* & scursor, const char * const send,
TQString & result, bool isCRLF=false ) TDE_EXPORT;
/** Eats comment-folding-white-space, skips whitespace, folding and
comments (even nested ones) and stops at the next non-CFWS
character. After calling this function, you should check whether
@p scursor == @p send (end of header reached).
If a comment with unbalanced parantheses is encountered, @p
scursor is being positioned on the opening '(' of the outmost
comment.
*/
void eatCFWS( const char* & scursor, const char * const send, bool isCRLF ) TDE_EXPORT;
bool parseDomain( const char* & scursor, const char * const send,
TQString & result, bool isCRLF=false ) TDE_EXPORT;
bool parseObsRoute( const char* & scursor, const char * const send,
TQStringList & result,
bool isCRLF=false, bool save=false ) TDE_EXPORT;
bool parseAddrSpec( const char* & scursor, const char * const send,
Types::AddrSpec & result, bool isCRLF=false ) TDE_EXPORT;
bool parseAngleAddr( const char* & scursor, const char * const send,
Types::AddrSpec & result, bool isCRLF=false ) TDE_EXPORT;
bool parseMailbox( const char* & scursor, const char * const send,
Types::Mailbox & result, bool isCRLF=false ) TDE_EXPORT;
bool parseGroup( const char* & scursor, const char * const send,
Types::Address & result, bool isCRLF=false ) TDE_EXPORT;
bool parseAddress( const char* & scursor, const char * const send,
Types::Address & result, bool isCRLF=false ) TDE_EXPORT;
bool parseAddressList( const char* & scursor, const char * const send,
Types::AddressList & result, bool isCRLF=false ) TDE_EXPORT;
bool parseParameter( const char* & scursor, const char * const send,
TQPair<TQString,Types::TQStringOrTQPair> & result,
bool isCRLF=false ) TDE_EXPORT;
bool parseParameterList( const char* & scursor, const char * const send,
TQMap<TQString,TQString> & result, bool isCRLF=false ) TDE_EXPORT;
bool parseRawParameterList( const char* & scursor, const char * const send,
TQMap<TQString,Types::TQStringOrTQPair> & result,
bool isCRLF=false ) TDE_EXPORT;
bool parseTime( const char* & scursor, const char * const send,
int & hour, int & min, int & sec, long int & secsEastOfGMT,
bool & timeZoneKnown, bool isCRLF=false ) TDE_EXPORT;
bool parseDateTime( const char* & scursor, const char * const send,
Types::DateTime & result, bool isCRLF=false ) TDE_EXPORT;
#if 0
bool tryToMakeAnySenseOfDateString( const char* & scursor,
const char * const send,
time_t & result, bool isCRLF=false );
#endif
} // namespace HeaderParsing
} // namespace KMime
#endif // __KMIME_HEADER_PARSING_H__