• Skip to content
  • Skip to link menu
KDE 4.5 API Reference
  • KDE API Reference
  • KDE-PIM Libraries
  • Sitemap
  • Contact Us
 

KMIME Library

kmime_util.h

00001 /*  -*- c++ -*-
00002     kmime_util.h
00003 
00004     KMime, the KDE Internet mail/usenet news message library.
00005     Copyright (c) 2001 the KMime authors.
00006     See file AUTHORS for details
00007 
00008     This library is free software; you can redistribute it and/or
00009     modify it under the terms of the GNU Library General Public
00010     License as published by the Free Software Foundation; either
00011     version 2 of the License, or (at your option) any later version.
00012 
00013     This library is distributed in the hope that it will be useful,
00014     but WITHOUT ANY WARRANTY; without even the implied warranty of
00015     MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
00016     Library General Public License for more details.
00017 
00018     You should have received a copy of the GNU Library General Public License
00019     along with this library; see the file COPYING.LIB.  If not, write to
00020     the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
00021     Boston, MA 02110-1301, USA.
00022 */
00023 #ifndef __KMIME_UTIL_H__
00024 #define __KMIME_UTIL_H__
00025 
00026 #include <QtCore/QString>
00027 #include "kmime_export.h"
00028 #include "kmime_headers.h"
00029 
00030 namespace KMime {
00031 
00037 KMIME_EXPORT extern QByteArray cachedCharset( const QByteArray &name );
00038 
00044 KMIME_EXPORT extern QByteArray cachedLanguage( const QByteArray &name );
00045 
00050 KMIME_EXPORT extern bool isUsAscii( const QString &s );
00051 
00058 KMIME_EXPORT extern QString nameForEncoding( KMime::Headers::contentEncoding enc );
00059 
00064 KMIME_EXPORT QList<KMime::Headers::contentEncoding> encodingsForData(
00065                                                        const QByteArray &data );
00066 //@cond PRIVATE
00067 extern const uchar specialsMap[16];
00068 extern const uchar tSpecialsMap[16];
00069 extern const uchar aTextMap[16];
00070 extern const uchar tTextMap[16];
00071 extern const uchar eTextMap[16];
00072 
00073 inline bool isOfSet( const uchar map[16], unsigned char ch )
00074 {
00075   return ( ch < 128 ) && ( map[ ch/8 ] & 0x80 >> ch%8 );
00076 }
00077 inline bool isSpecial( char ch )
00078 {
00079   return isOfSet( specialsMap, ch );
00080 }
00081 inline bool isTSpecial( char ch )
00082 {
00083   return isOfSet( tSpecialsMap, ch );
00084 }
00085 inline bool isAText( char ch )
00086 {
00087   return isOfSet( aTextMap, ch );
00088 }
00089 inline bool isTText( char ch )
00090 {
00091   return isOfSet( tTextMap, ch );
00092 }
00093 inline bool isEText( char ch )
00094 {
00095   return isOfSet( eTextMap, ch );
00096 }
00097 //@endcond
00098 
00108 KMIME_EXPORT extern void setFallbackCharEncoding( const QString& fallbackCharEnc );
00109 
00118 KMIME_EXPORT extern QString fallbackCharEncoding();
00119 
00131 KMIME_EXPORT extern void setUseOutlookAttachmentEncoding( bool violateStandard );
00132 
00136 KMIME_EXPORT extern bool useOutlookAttachmentEncoding();
00149 KMIME_EXPORT extern QString decodeRFC2047String(
00150   const QByteArray &src, QByteArray &usedCS, const QByteArray &defaultCS = QByteArray(),
00151   bool forceCS = false );
00152 
00159 KMIME_EXPORT extern QString decodeRFC2047String( const QByteArray &src );
00160 
00172 KMIME_EXPORT extern QByteArray encodeRFC2047String(
00173   const QString &src, const QByteArray &charset, bool addressHeader=false,
00174   bool allow8bitHeaders=false );
00175 
00176 
00188 KMIME_EXPORT extern QString decodeRFC2231String(
00189   const QByteArray &src, QByteArray &usedCS, const QByteArray &defaultCS = QByteArray(),
00190   bool forceCS = false );
00191 
00198 KMIME_EXPORT extern QString decodeRFC2231String( const QByteArray &src );
00199 
00200 
00208 KMIME_EXPORT extern QByteArray encodeRFC2231String( const QString &src, const QByteArray &charset );
00209 
00218 KMIME_EXPORT extern QByteArray uniqueString();
00219 
00228 KMIME_EXPORT extern QByteArray multiPartBoundary();
00229 
00234 KMIME_EXPORT extern QByteArray unfoldHeader( const QByteArray &header );
00235 
00246 KMIME_EXPORT extern QByteArray extractHeader( const QByteArray &src,
00247                                  const QByteArray &name );
00248 
00260 KMIME_EXPORT extern QList<QByteArray> extractHeaders( const QByteArray &src,
00261                                  const QByteArray &name );
00262 
00275 KMIME_EXPORT extern QByteArray CRLFtoLF( const QByteArray &s );
00276 
00289 KMIME_EXPORT extern QByteArray CRLFtoLF( const char *s );
00290 
00304 KMIME_EXPORT extern QByteArray LFtoCRLF( const QByteArray &s );
00305 
00313 //AK_REVIEW: add correctly spelled methods and deprecated the wrongly spelled
00314 // TODO: KDE5: BIC: rename to "removeQuotes"
00315 KMIME_EXPORT extern void removeQuots( QByteArray &str );
00316 
00324 //AK_REVIEW: add correctly spelled methods and deprecated the wrongly spelled
00325 // TODO: KDE5: BIC: rename to "removeQuotes"
00326 KMIME_EXPORT extern void removeQuots( QString &str );
00327 
00335 KMIME_EXPORT extern void addQuotes( QByteArray &str, bool forceQuotes );
00336 
00341 KMIME_EXPORT extern void addQuotes( QString &str, bool forceQuotes );
00342 
00384 KMIME_EXPORT QString balanceBidiState( const QString &input );
00385 
00392 KMIME_EXPORT QString removeBidiControlChars( const QString &input );
00393 
00394 } // namespace KMime
00395 
00396 #endif /* __KMIME_UTIL_H__ */

KMIME Library

Skip menu "KMIME Library"
  • Main Page
  • Namespace List
  • Class Hierarchy
  • Alphabetical List
  • Class List
  • File List
  • Namespace Members
  • Class Members
  • Related Pages

KDE-PIM Libraries

Skip menu "KDE-PIM Libraries"
  • akonadi
  •   contact
  •   kmime
  • kabc
  • kblog
  • kcal
  • kholidays
  • kimap
  • kioslave
  •   imap4
  •   mbox
  •   nntp
  • kldap
  • kmime
  • kontactinterface
  • kpimidentities
  • kpimtextedit
  •   richtextbuilders
  • kpimutils
  • kresources
  • ktnef
  • kxmlrpcclient
  • mailtransport
  • microblog
  • qgpgme
  • syndication
  •   atom
  •   rdf
  •   rss2
Generated for KDE-PIM Libraries by doxygen 1.7.1
This website is maintained by Adriaan de Groot and Allen Winter.
KDE® and the K Desktop Environment® logo are registered trademarks of KDE e.V. | Legal