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

KMIME Library

KMime::Headers::Generics::MailboxList

KMime::Headers::Generics::MailboxList Class Reference

Base class for headers that deal with (possibly multiple) addresses, but don't allow groups. More...

#include <kmime_headers.h>

Inheritance diagram for KMime::Headers::Generics::MailboxList:
Inheritance graph
[legend]

List of all members.

Public Member Functions

void addAddress (const QByteArray &address, const QString &displayName=QString())
void addAddress (const Types::Mailbox &mbox)
QList< QByteArray > addresses () const
virtual QByteArray as7BitString (bool withHeaderType=true) const
virtual QString asUnicodeString () const
virtual void clear ()
QStringList displayNames () const
virtual void fromUnicodeString (const QString &s, const QByteArray &b)
virtual bool isEmpty () const
Types::Mailbox::List mailboxes () const
QStringList prettyAddresses () const

Protected Member Functions

bool parse (const char *&scursor, const char *const send, bool isCRLF=false)

Detailed Description

Base class for headers that deal with (possibly multiple) addresses, but don't allow groups.

See also:
RFC 2822, section 3.4

Definition at line 386 of file kmime_headers.h.


Member Function Documentation

void KMime::Headers::Generics::MailboxList::addAddress ( const QByteArray &  address,
const QString &  displayName = QString() 
)

Adds an address to this header.

Parameters:
address The actual email address, with or without angle brackets.
displayName An optional name associated with the address.

Definition at line 435 of file kmime_headers.cpp.

void KMime::Headers::Generics::MailboxList::addAddress ( const Types::Mailbox &  mbox  ) 

Adds an address to this header.

Parameters:
mbox A Mailbox object specifying the address.

Definition at line 429 of file kmime_headers.cpp.

QList< QByteArray > KMime::Headers::Generics::MailboxList::addresses (  )  const

Returns a list of all addresses in this header, regardless of groups.

Definition at line 445 of file kmime_headers.cpp.

Address QByteArray KMime::Headers::Generics::MailboxList::as7BitString ( bool  withHeaderType = true  )  const [virtual]

Returns the encoded header.

Parameters:
withHeaderType Specifies whether the header-type should be included.

Implements KMime::Headers::Base.

Definition at line 387 of file kmime_headers.cpp.

QString KMime::Headers::Generics::MailboxList::asUnicodeString (  )  const [virtual]

Returns the decoded content of the header without the header-type.

Reimplemented from KMime::Headers::Generics::Structured.

Definition at line 413 of file kmime_headers.cpp.

void KMime::Headers::Generics::MailboxList::clear (  )  [virtual]

Deletes.

Implements KMime::Headers::Base.

Definition at line 418 of file kmime_headers.cpp.

QStringList KMime::Headers::Generics::MailboxList::displayNames (  )  const

Returns a list of all display names associated with the addresses in this header.

An empty entry is added for addresses that do not have a display name.

Definition at line 454 of file kmime_headers.cpp.

void KMime::Headers::Generics::MailboxList::fromUnicodeString ( const QString &  s,
const QByteArray &  b 
) [virtual]

Parses the given string and set the charset.

Parameters:
s The header data as unicode string.
b The charset preferred for encoding.

Reimplemented from KMime::Headers::Generics::Structured.

Definition at line 406 of file kmime_headers.cpp.

bool KMime::Headers::Generics::MailboxList::isEmpty (  )  const [virtual]

Checks if this header contains any data.

Implements KMime::Headers::Base.

Definition at line 424 of file kmime_headers.cpp.

Types::Mailbox::List KMime::Headers::Generics::MailboxList::mailboxes (  )  const

Returns a list of mailboxes listed in this header.

Definition at line 472 of file kmime_headers.cpp.

bool KMime::Headers::Generics::MailboxList::parse ( const char *&  scursor,
const char *const   send,
bool  isCRLF = false 
) [protected, virtual]

This method parses the raw header and needs to be implemented in every sub-class.

Parameters:
scursor Pointer to the start of the data still to parse.
send Pointer to the end of the data.
isCRLF true if input string is terminated with a CRLF.

Implements KMime::Headers::Generics::Structured.

Reimplemented in KMime::Headers::Generics::SingleMailbox.

Definition at line 477 of file kmime_headers.cpp.

QStringList KMime::Headers::Generics::MailboxList::prettyAddresses (  )  const

Returns a list of assembled display name / address strings of the following form: "Display Name &lt;address&gt;".

These are unicode strings without any transport encoding, ie. they are only suitable for displaying.

Definition at line 463 of file kmime_headers.cpp.


The documentation for this class was generated from the following files:
  • kmime_headers.h
  • kmime_headers.cpp

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.6.2-20100208
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