diff options
author | Christian Mollekopf <chrigi_1@fastmail.fm> | 2012-06-25 23:43:13 (GMT) |
---|---|---|
committer | Christian Mollekopf <chrigi_1@fastmail.fm> | 2012-06-25 23:43:13 (GMT) |
commit | e21e62c14f5aae99d46643065fcb86e2e3abe230 (patch) | |
tree | 71d79d2de0b0f82f8b0a6ca3b8b09308d198ed33 /kimap/rfccodecs.h | |
parent | 172803b38237e38a494aca62fffda918e5799d20 (diff) | |
download | libcalendaring-e21e62c14f5aae99d46643065fcb86e2e3abe230.tar.gz |
initial import of kimap from
commit b54a325116b194da090f900c9a538710759eb303
Author: Stephen Kelly <steveire@gmail.com>
Date: Sun May 6 20:44:53 2012 +0200
Revert "Port to const QRegExp API."
This reverts commit 0ca0dfc7e0ca8095efd0b060d1d5e26ac9ceb379.
The qtbase commit requiring this was reverted.
Diffstat (limited to 'kimap/rfccodecs.h')
-rw-r--r-- | kimap/rfccodecs.h | 139 |
1 files changed, 139 insertions, 0 deletions
diff --git a/kimap/rfccodecs.h b/kimap/rfccodecs.h new file mode 100644 index 0000000..922189c --- /dev/null +++ b/kimap/rfccodecs.h @@ -0,0 +1,139 @@ +/********************************************************************** + * + * rfccodecs - handler for various rfc/mime encodings + * Copyright (C) 2000 s.carstens@gmx.de + * + * 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; see the file COPYING.LIB. If not, write to + * the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, + * Boston, MA 02110-1301, USA. + * + *********************************************************************/ +/** + * @file + * This file is part of the IMAP support library and defines the + * RfcCodecs class. + * + * @brief + * Provides handlers for various RFC/MIME encodings. + * + * @author Sven Carstens + */ + +#ifndef KIMAP_RFCCODECS_H +#define KIMAP_RFCCODECS_H + +#include <QtCore/QString> + +#include "kimap_export.h" + +class QTextCodec; + +namespace KIMAP { + + /** + Converts an Unicode IMAP mailbox to a QByteArray which can be used in + IMAP communication. + @param src is the QByteArray containing the IMAP mailbox. + @since 4.3 + */ + KIMAP_EXPORT QByteArray encodeImapFolderName( const QByteArray &src ); + + /** + Converts an UTF-7 encoded IMAP mailbox to a QByteArray + @param inSrc is the QByteArray containing the Unicode path. + @since 4.3 + */ + KIMAP_EXPORT QByteArray decodeImapFolderName( const QByteArray &inSrc ); + /** + Converts an Unicode IMAP mailbox to a QString which can be used in + IMAP communication. + @param src is the QString containing the IMAP mailbox. + */ + KIMAP_EXPORT QString encodeImapFolderName( const QString &src ); + + /** + Converts an UTF-7 encoded IMAP mailbox to a Unicode QString. + @param inSrc is the QString containing the Unicode path. + */ + KIMAP_EXPORT QString decodeImapFolderName( const QString &inSrc ); + + /** + Replaces " with \" and \ with \\ " and \ characters. + @param src is the QString to quote. + */ + KIMAP_EXPORT QString quoteIMAP( const QString &src ); + + /** + Replaces " with \" and \ with \\ " and \ characters. + @param src is the QString to quote. + @since 4.3 + */ + KIMAP_EXPORT QByteArray quoteIMAP( const QByteArray &src ); + + /** + Fetches a Codec by @p name. + @param name is the QString version of the Codec name. + @return Text Codec object + */ + KIMAP_EXPORT QTextCodec *codecForName( const QString &name ); + + /** + Decodes a RFC2047 string @p str. + @param str is the QString to decode. + @param charset is the character set to use when decoding. + @param language is the language found in the charset. + */ + KIMAP_EXPORT const QString decodeRFC2047String( const QString &str, + QString &charset, + QString &language ); + /** + Decodes a RFC2047 string @p str. + @param str is the QString to decode. + @param charset is the character set to use when decoding. + */ + KIMAP_EXPORT const QString decodeRFC2047String( const QString &str, + QString &charset ); + + /** + Decodes a RFC2047 string @p str. + @param str is the QString to decode. + */ + KIMAP_EXPORT const QString decodeRFC2047String( const QString &str ); + + /** + Encodes a RFC2047 string @p str. + @param str is the QString to encode. + */ + KIMAP_EXPORT const QString encodeRFC2047String( const QString &str ); + + /** + Encodes a RFC2047 string @p str. + @param str is the QString to encode. + */ + KIMAP_EXPORT const QByteArray encodeRFC2047String( const QByteArray &str ); + + /** + Encodes a RFC2231 string @p str. + @param str is the QString to encode. + */ + KIMAP_EXPORT const QString encodeRFC2231String( const QString &str ); + + /** + Decodes a RFC2231 string @p str. + @param str is the QString to decode. + */ + KIMAP_EXPORT const QString decodeRFC2231String( const QString &str ); +} + +#endif |