VMime
parameter Class Reference
Inheritance diagram for parameter:
Collaboration diagram for parameter:

Public Member Functions

 parameter (const string &name)
 
 parameter (const string &name, const word &value)
 
 parameter (const string &name, const string &value)
 
shared_ptr< componentclone () const
 
void copyFrom (const component &other)
 
parameteroperator= (const parameter &other)
 
const std::vector< shared_ptr
< component > > 
getChildComponents ()
 
const stringgetName () const
 
const wordgetValue () const
 
template<typename T >
const T getValueAs () const
 
void setValue (const component &value)
 
void setValue (const word &value)
 
- Public Member Functions inherited from component
 component ()
 
virtual ~component ()
 
void parse (const string &buffer)
 
void parse (const parsingContext &ctx, const string &buffer)
 
void parse (shared_ptr< utility::inputStream > inputStream, const size_t length)
 
void parse (const string &buffer, const size_t position, const size_t end, size_t *newPosition=NULL)
 
void parse (const parsingContext &ctx, const string &buffer, const size_t position, const size_t end, size_t *newPosition=NULL)
 
void parse (shared_ptr< utility::inputStream > inputStream, const size_t position, const size_t end, size_t *newPosition=NULL)
 
void parse (const parsingContext &ctx, shared_ptr< utility::inputStream > inputStream, const size_t position, const size_t end, size_t *newPosition=NULL)
 
virtual const string generate (const size_t maxLineLength=lineLengthLimits::infinite, const size_t curLinePos=0) const
 
virtual void generate (utility::outputStream &outputStream, const size_t curLinePos=0, size_t *newLinePos=NULL) const
 
virtual void generate (const generationContext &ctx, utility::outputStream &outputStream, const size_t curLinePos=0, size_t *newLinePos=NULL) const
 
size_t getParsedOffset () const
 
size_t getParsedLength () const
 
virtual size_t getGeneratedSize (const generationContext &ctx)
 

Protected Member Functions

void parseImpl (const parsingContext &ctx, const string &buffer, const size_t position, const size_t end, size_t *newPosition=NULL)
 
void generateImpl (const generationContext &ctx, utility::outputStream &os, const size_t curLinePos=0, size_t *newLinePos=NULL) const
 
- Protected Member Functions inherited from component
void setParsedBounds (const size_t start, const size_t end)
 
virtual void parseImpl (const parsingContext &ctx, shared_ptr< utility::parserInputStreamAdapter > parser, const size_t position, const size_t end, size_t *newPosition=NULL)
 
- Protected Member Functions inherited from object
 object ()
 
 object (const object &)
 
objectoperator= (const object &)
 
virtual ~object ()
 

Constructor & Destructor Documentation

parameter ( const string name)

Construct a parameter with no value.

Charset is set to the current locale charset.

Parameters
nameparameter name
parameter ( const string name,
const word value 
)

Construct a parameter given a name and a value.

Parameters
nameparameter name
valueparameter value
parameter ( const string name,
const string value 
)

Construct a parameter given a name and a string value expressed in the current locale charset.

Parameters
nameparameter name
valueparameter value

Member Function Documentation

shared_ptr< component > clone ( ) const
virtual

Clone this component.

Returns
a copy of this component

Implements component.

void copyFrom ( const component other)
virtual

Replace data in this component by data in other component.

Both components must be of the same type.

Exceptions
std::bad_cast_exceptionif the components are not of the same (dynamic) type
Parameters
otherother component to copy data from

Implements component.

Referenced by parameter::operator=().

const std::vector< shared_ptr< component > > getChildComponents ( )
virtual

Return the list of children of this component.

Returns
list of child components

Implements component.

const string & getName ( ) const

Return the name of this parameter.

Returns
name of this parameter
const word & getValue ( ) const

Return the raw value of this parameter.

Returns
read-only value
const T getValueAs ( ) const

Return the value of this object in the specified type.

For example, the following code:

   getParameter("creation-date")->getValueAs <vmime::dateTime>()

is equivalent to:

   shared_ptr <vmime::word> rawValue = getParameter("creation-date");
   vmime::dateTime theDate;
   theDate.parse(rawValue->getBuffer());
Parameters
Ttype to which convert the value
Returns
value
parameter & operator= ( const parameter other)

References parameter::copyFrom().

void parseImpl ( const parsingContext ctx,
const string buffer,
const size_t  position,
const size_t  end,
size_t newPosition = NULL 
)
protectedvirtual
void setValue ( const component value)

Set the value of this parameter.

Parameters
valuenew value

References component::generate(), and vmime::charsets::US_ASCII.

void setValue ( const word value)

Set the raw value of this parameter.

Parameters
valuenew value

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