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

#include <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< QByteArray >	addresses () 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) override
void	fromUnicodeString (const QString &s, const QByteArray &b)
bool	isEmpty () const override
Types::Mailbox::List	mailboxes () const
Public Member Functions inherited from KMime::Headers::Generics::Structured
QString	asUnicodeString () const override
void	from7BitString (QByteArrayView s) override
void	fromUnicodeString (const QString &s) override
void	fromUnicodeString (const QString &s, const QByteArray &b)
Public Member Functions inherited from KMime::Headers::Base
	Base ()
virtual	~Base ()
void	fromUnicodeString (const QString &s, const QByteArray &b)
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 337 of file 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.

Parameters

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

Definition at line 328 of file headers.cpp.

addAddress() [2/2]

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 322 of file 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 338 of file headers.cpp.

as7BitString()

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

overridevirtual

Returns the encoded header.

Parameters

withHeaderType

Specifies whether the header-type should be included.

Implements KMime::Headers::Base.

Definition at line 280 of file headers.cpp.

asUnicodeString()

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

overridevirtual

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

Note

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 305 of file headers.cpp.

clear()

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

overridevirtual

Deletes.

Implements KMime::Headers::Base.

Definition at line 311 of file 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 348 of file 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(", ").

Since

5.14

Definition at line 363 of file headers.cpp.

fromUnicodeString() [1/2]

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

overridevirtual

Parses the given Unicode representation of the header content.

Parameters

s	The header data as Unicode string.

Implements KMime::Headers::Base.

Definition at line 299 of file headers.cpp.

fromUnicodeString() [2/2]

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

inline

Definition at line 144 of file headers.h.

isEmpty()

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

overridevirtual

Checks if this header contains any data.

Implements KMime::Headers::Base.

Definition at line 317 of file headers.cpp.

mailboxes()

Types::Mailbox::List KMime::Headers::Generics::MailboxList::mailboxes

(

)

const

Returns a list of mailboxes listed in this header.

Definition at line 377 of file headers.cpp.

parse()

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

overrideprotectedvirtual

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 382 of file headers.cpp.

---

The documentation for this class was generated from the following files:

• headers.h
• headers.cpp