Isis Developer Reference
Isis::PvlToken Class Reference

Container for Keyword-value pair. More...

#include <PvlToken.h>

Collaboration diagram for Isis::PvlToken:
Collaboration graph

Public Member Functions

 PvlToken (const QString &k)
 Constructs a Token with k for keyword and NULL for the value list.
 
 PvlToken ()
 Constructs a Token with NULL for both the keyword and value list.
 
 ~PvlToken ()
 Destroys the Token object.
 
void setKey (const QString &k)
 Set the token keyword.
 
QString key () const
 Returns the token keyword.
 
QString keyUpper () const
 Returns the token keyword in all uppercase characters.
 
void addValue (const QString &v)
 Adds a value to the value-vector.
 
QString value (const int index=0) const
 Returns one element of the value-vector.
 
QString valueUpper (const int index=0) const
 Returns one element of the value-vector in uppercase.
 
int valueSize () const
 Returns the number of elements in the value-vector.
 
void valueClear ()
 Removes all elements from the value-vector.
 
const std::vector< QString > & valueVector () const
 

Detailed Description

Container for Keyword-value pair.

This class is used for internalizing keyword-value(s) pairs. For example, SPACECRAFT=MARS_GLOBAL_SURVEYOR or FROM=file.cub. This is useful when parsing ASCII files such as PDS labels or command lines.

Author
2002-03-18 Jeff Anderson

Constructor & Destructor Documentation

◆ PvlToken() [1/2]

Isis::PvlToken::PvlToken ( const QString & k)

Constructs a Token with k for keyword and NULL for the value list.

Parameters
kValue of the keyword

References setKey(), and valueClear().

◆ PvlToken() [2/2]

Isis::PvlToken::PvlToken ( )

Constructs a Token with NULL for both the keyword and value list.

References valueClear().

◆ ~PvlToken()

Isis::PvlToken::~PvlToken ( )

Destroys the Token object.

References valueClear().

Member Function Documentation

◆ addValue()

void Isis::PvlToken::addValue ( const QString & v)

Adds a value to the value-vector.

Successive calls add values to the end of the vector.

Parameters
vIString add to the value-vector list

◆ key()

QString Isis::PvlToken::key ( ) const

Returns the token keyword.

Returns
QString

◆ keyUpper()

QString Isis::PvlToken::keyUpper ( ) const

Returns the token keyword in all uppercase characters.

Returns
QString

◆ setKey()

void Isis::PvlToken::setKey ( const QString & k)

Set the token keyword.

Parameters
kIString to load into the token keyword

Referenced by PvlToken().

◆ value()

QString Isis::PvlToken::value ( const int index = 0) const

Returns one element of the value-vector.

Parameters
indexZero-based index of vector element to return. Defaults to 0
Returns
QString
Exceptions
Isis::IException::Programmer

References _FILEINFO_, Isis::Message::ArraySubscriptNotInRange(), and Isis::IException::Programmer.

◆ valueClear()

void Isis::PvlToken::valueClear ( )

Removes all elements from the value-vector.

Referenced by PvlToken(), PvlToken(), and ~PvlToken().

◆ valueSize()

int Isis::PvlToken::valueSize ( ) const

Returns the number of elements in the value-vector.

Returns
int

◆ valueUpper()

QString Isis::PvlToken::valueUpper ( const int index = 0) const

Returns one element of the value-vector in uppercase.

Parameters
indexZero-based index of vector element to return. Defaults to 0
Returns
QString
Exceptions
Isis::IException::Programmer

References _FILEINFO_, Isis::Message::ArraySubscriptNotInRange(), and Isis::IException::Programmer.

◆ valueVector()

const std::vector< QString > & Isis::PvlToken::valueVector ( ) const
inline

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