Search for usage in LXR

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

#include <kmime_headers.h>

Inheritance diagram for KMime::Headers::Generics::MailboxList:

Public Member Functions

void addAddress (const QByteArray &address, const QString &displayName=QString())
void addAddress (const Types::Mailbox &mbox)
QList< QByteArrayaddresses () const
QByteArray as7BitString (bool withHeaderType=true) const override
QString asUnicodeString () const override
void clear () override
QStringList displayNames () const
QString displayString () const
void fromUnicodeString (const QString &s, const QByteArray &b) override
bool isEmpty () const override
Types::Mailbox::List mailboxes () const
- Public Member Functions inherited from KMime::Headers::Generics::Structured
QString asUnicodeString () const override
void from7BitString (const char *s, size_t len) override
void from7BitString (const QByteArray &s) override
void fromUnicodeString (const QString &s, const QByteArray &b) override
- Public Member Functions inherited from KMime::Headers::Base
 Base ()
virtual ~Base ()
bool is (const char *t) const
bool isMimeHeader () const
QByteArray rfc2047Charset () const
void setRFC2047Charset (const QByteArray &cs)
virtual const char * type () const

Protected Member Functions

bool parse (const char *&scursor, const char *const send, bool isCRLF=false) override
- Protected Member Functions inherited from KMime::Headers::Base
QByteArray typeIntro () const

Additional Inherited Members

- Public Types inherited from KMime::Headers::Base
typedef QList< KMime::Headers::Base * > List

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 333 of file kmime_headers.h.

Member Function Documentation

◆ addAddress() [1/2]

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

Adds an address to this header.

addressThe actual email address, with or without angle brackets.
displayNameAn optional name associated with the address.

Definition at line 348 of file kmime_headers.cpp.

◆ addAddress() [2/2]

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

Adds an address to this header.

mboxA Mailbox object specifying the address.

Definition at line 342 of file kmime_headers.cpp.

◆ addresses()

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

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

Definition at line 358 of file kmime_headers.cpp.

◆ as7BitString()

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

Returns the encoded header.

withHeaderTypeSpecifies whether the header-type should be included.

Implements KMime::Headers::Base.

Definition at line 299 of file kmime_headers.cpp.

◆ asUnicodeString()

QString KMime::Headers::Generics::MailboxList::asUnicodeString ( ) const

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

The return value of this method should only be used when showing an address to the user. It is not guaranteed that fromUnicodeString( asUnicodeString(), ... ) will return the original string.

Implements KMime::Headers::Base.

Definition at line 325 of file kmime_headers.cpp.

◆ clear()

void KMime::Headers::Generics::MailboxList::clear ( )


Implements KMime::Headers::Base.

Definition at line 331 of file kmime_headers.cpp.

◆ displayNames()

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

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

The address is added for addresses that do not have a display name.

Definition at line 368 of file kmime_headers.cpp.

◆ displayString()

QString KMime::Headers::Generics::MailboxList::displayString ( ) const

Returns a single string for user-facing display of this mailbox list.

This is equivalent to displayNames().join(", ").


Definition at line 383 of file kmime_headers.cpp.

◆ fromUnicodeString()

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

Parses the given string and set the charset.

sThe header data as unicode string.
bThe charset preferred for encoding.

Implements KMime::Headers::Base.

Definition at line 318 of file kmime_headers.cpp.

◆ isEmpty()

bool KMime::Headers::Generics::MailboxList::isEmpty ( ) const

Checks if this header contains any data.

Implements KMime::Headers::Base.

Definition at line 337 of file kmime_headers.cpp.

◆ mailboxes()

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

Returns a list of mailboxes listed in this header.

Definition at line 397 of file kmime_headers.cpp.

◆ parse()

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

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

scursorPointer to the start of the data still to parse.
sendPointer to the end of the data.
isCRLFtrue if input string is terminated with a CRLF.

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

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

Definition at line 402 of file kmime_headers.cpp.

The documentation for this class was generated from the following files:
This file is part of the KDE documentation.
Documentation copyright © 1996-2024 The KDE developers.
Generated on Tue Mar 26 2024 11:20:12 by doxygen 1.10.0 written by Dimitri van Heesch, © 1997-2006

KDE's Doxygen guidelines are available online.