#include <generationContext.hpp>

Inheritance diagram for generationContext:

[legend]

Collaboration diagram for generationContext:

[legend]

Public Types
enum	EncodedParameterValueModes { PARAMETER_VALUE_NO_ENCODING , PARAMETER_VALUE_RFC2047_ONLY , PARAMETER_VALUE_RFC2231_ONLY , PARAMETER_VALUE_RFC2231_AND_RFC2047 }

Public Member Functions
	generationContext ()

	generationContext (const generationContext &ctx)

size_t	getMaxLineLength () const

void	setMaxLineLength (const size_t maxLineLength)

const string	getPrologText () const

void	setPrologText (const string &prologText)

const string	getEpilogText () const

void	setEpilogText (const string &epilogText)

bool	getWrapMessageId () const

void	setWrapMessageId (const bool &wrapMessageId)

void	setEncodedParameterValueMode (const EncodedParameterValueModes mode)

EncodedParameterValueModes	getEncodedParameterValueMode () const

generationContext &	operator= (const generationContext &ctx)

void	copyFrom (const generationContext &ctx)

Public Member Functions inherited from context
virtual	~context ()

bool	getInternationalizedEmailSupport () const

void	setInternationalizedEmailSupport (const bool support)

const charsetConverterOptions &	getCharsetConversionOptions () const

void	setCharsetConversionOptions (const charsetConverterOptions &opts)

Static Public Member Functions
static generationContext &	getDefaultContext ()

Protected Attributes
size_t	m_maxLineLength

string	m_prologText

string	m_epilogText

bool	m_wrapMessageId

EncodedParameterValueModes	m_paramValueMode

Protected Attributes inherited from context
bool	m_internationalizedEmail

charsetConverterOptions	m_charsetConvOptions

Additional Inherited Members
Protected Member Functions inherited from context
	context ()

	context (const context &ctx)

virtual context &	operator= (const context &ctx)

void	copyFrom (const context &ctx)

Protected Member Functions inherited from object
	object ()

	object (const object &)

object &	operator= (const object &)

virtual	~object ()

Detailed Description

Holds configuration parameters used for generating messages.

Member Enumeration Documentation

◆ EncodedParameterValueModes

enum EncodedParameterValueModes

Modes available for generating values in parameterized header fields.

Enumerator
PARAMETER_VALUE_NO_ENCODING	Only generate 7-bit (ASCII-only) values, even if the value contains non-ASCII chars or if folding is needed.
PARAMETER_VALUE_RFC2047_ONLY	Only generate RFC-2047 values (do not use RFC-2231). This is non-standard but most mail clients support it.
PARAMETER_VALUE_RFC2231_ONLY	Only generate RFC-2231 values (do not use RFC-2047). Some mail clients may not support it. This is the default.
PARAMETER_VALUE_RFC2231_AND_RFC2047	Generate both RFC-2047- and RFC-2231-encoded values.

Constructor & Destructor Documentation

◆ generationContext() [1/2]

generationContext ( )

◆ generationContext() [2/2]

generationContext ( const generationContext & ctx )

Member Function Documentation

◆ copyFrom()

void copyFrom ( const generationContext & ctx )

References context::copyFrom(), vmime::dynamicCast(), generationContext::m_epilogText, generationContext::m_maxLineLength, generationContext::m_paramValueMode, and generationContext::m_prologText.

Referenced by generationContext::operator=().

◆ getDefaultContext()

generationContext & getDefaultContext ( )

static

Returns the default context used for generating messages.

Returns: a reference to the default generation context

References vmime::dynamicCast().

Referenced by component::generate(), component::generate(), SMTPTransport::send(), and emailAddress::toString().

◆ getEncodedParameterValueMode()

generationContext::EncodedParameterValueModes getEncodedParameterValueMode ( ) const

Returns the mode used for generating parameter values in a parameterized header field (see parameterizedHeaderField class).

Returns: parameter value generation mode

References generationContext::m_paramValueMode.

◆ getEpilogText()

const string getEpilogText ( ) const

Returns the current epilog text used when generating MIME body parts.

Returns: current MIME epilog text

References generationContext::m_epilogText.

◆ getMaxLineLength()

size_t getMaxLineLength ( ) const

Returns the current maximum line length used when generating messages.

Returns: current maximum line length, in bytes

References generationContext::m_maxLineLength.

Referenced by addressList::generateImpl().

◆ getPrologText()

const string getPrologText ( ) const

Returns the current prolog text used when generating MIME body parts.

Returns: current MIME prolog text

References generationContext::m_prologText.

◆ getWrapMessageId()

bool getWrapMessageId ( ) const

Returns a boolean variable that indicates whether the message id can be wrapped or not, i.e.

from

Message-Id: <very very long@domain>

to

Message-Id:
 <very very long@domain>

Returns: boolean indicating if the Message-Id can be wrapped

References generationContext::m_wrapMessageId.

◆ operator=()

generationContext & operator= ( const generationContext & ctx )

References generationContext::copyFrom(), and vmime::dynamicCast().

◆ setEncodedParameterValueMode()

void setEncodedParameterValueMode ( const EncodedParameterValueModes mode )

Sets the mode used for generating parameter values in a parameterized header field (see parameterizedHeaderField class).

PARAMETER_VALUE_NO_ENCODING or PARAMETER_VALUE_RFC2047_ONLY can be used for compatibility with implementations that do not understand RFC-2231, to generate a normal parameter value. PARAMETER_VALUE_RFC2047_ONLY is non-standard (and expressly prohibited by the RFC) but most mail clients support it.

Notice: if both the normal value and the extended value are present, the latter can be ignored by mail processing systems. This may lead to annoying problems, for example, with strange names of attachments with all but 7-bit ascii characters removed, etc. Either PARAMETER_VALUE_RFC2231_ONLY or PARAMETER_VALUE_RFC2047_ONLY should be preferred over PARAMETER_VALUE_RFC2231_AND_RFC2047, not to create a normal value if the extended value is to be generated.

Parameters