diff options
Diffstat (limited to 'libkmime/kmime_codec_base64.h')
-rw-r--r-- | libkmime/kmime_codec_base64.h | 112 |
1 files changed, 112 insertions, 0 deletions
diff --git a/libkmime/kmime_codec_base64.h b/libkmime/kmime_codec_base64.h new file mode 100644 index 000000000..11fa04b73 --- /dev/null +++ b/libkmime/kmime_codec_base64.h @@ -0,0 +1,112 @@ +/* -*- c++ -*- + kmime_codec_base64.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 Qt library by Trolltech AS, Norway (or with modified versions + of Qt that use the same license as Qt), 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 + Qt. 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_CODEC_BASE64__ +#define __KMIME_CODEC_BASE64__ + +#include "kmime_codecs.h" + +namespace KMime { + +class Base64Codec : public Codec { +protected: + friend class Codec; + Base64Codec() : Codec() {} + +public: + virtual ~Base64Codec() {} + + const char * name() const { + return "base64"; + } + + int maxEncodedSizeFor( int insize, bool withCRLF=false ) const { + // first, the total number of 4-char packets will be: + int totalNumPackets = ( insize + 2 ) / 3; + // now, after every 76/4'th packet there needs to be a linebreak: + int numLineBreaks = totalNumPackets / (76/4); + // and at the very end, too: + ++numLineBreaks; + // putting it all together, we have: + return 4 * totalNumPackets + ( withCRLF ? 2 : 1 ) * numLineBreaks; + } + + int maxDecodedSizeFor( int insize, bool withCRLF=false ) const { + // assuming all characters are part of the base64 stream (which + // does almost never hold due to required linebreaking; but + // additional non-base64 chars don't affect the output size), each + // 4-tupel of them becomes a 3-tupel in the decoded octet + // stream. So: + int result = ( ( insize + 3 ) / 4 ) * 3; + // but all of them may be \n, so + if ( withCRLF ) + result *= 2; // :-o + + return result; + } + + Encoder * makeEncoder( bool withCRLF=false ) const; + Decoder * makeDecoder( bool withCRLF=false ) const; +}; + + + +class Rfc2047BEncodingCodec : public Base64Codec { +protected: + friend class Codec; + Rfc2047BEncodingCodec() + : Base64Codec() {} + +public: + virtual ~Rfc2047BEncodingCodec() {} + + const char * name() const { return "b"; } + + int maxEncodedSizeFor( int insize, bool withCRLF=false ) const { + (void)withCRLF; // keep compiler happy + // Each (begun) 3-octet triple becomes a 4 char quartet, so: + return ( ( insize + 2 ) / 3 ) * 4; + } + + int maxDecodedSizeFor( int insize, bool withCRLF=false ) const { + (void)withCRLF; // keep compiler happy + // Each 4-char quartet becomes a 3-octet triple, the last one + // possibly even less. So: + return ( ( insize + 3 ) / 4 ) * 3; + } + + Encoder * makeEncoder( bool withCRLF=false ) const; +}; + + +} // namespace KMime + +#endif // __KMIME_CODEC_BASE64__ |