Isis Developer Reference
|
A single keyword-value pair. More...
#include <PvlKeyword.h>
Public Member Functions | |
PvlKeyword () | |
Constructs a blank PvlKeyword object. | |
PvlKeyword (QString name) | |
Constructs a PvlKeyword object with a name. | |
PvlKeyword (QString name, QString value, QString unit="") | |
Constructs a PvlKeyword object with a name, value and units. | |
PvlKeyword (const PvlKeyword &other) | |
Copy constructor. | |
~PvlKeyword () | |
Destructs a PvlKeyword object. | |
void | setName (QString name) |
Sets the keyword name. | |
QString | name () const |
Returns the keyword name. | |
bool | isNamed (QString name) const |
Determines whether two PvlKeywords have the same name or not. | |
void | setValue (QString value, QString unit="") |
Sets new values. | |
void | setJsonValue (nlohmann::json jsonobj, QString unit="") |
Sets new value from Json. | |
void | setUnits (QString units) |
Sets the unit of measure for all current values if any exist. | |
void | setUnits (QString value, QString units) |
Sets the unit of measure for a given value. | |
PvlKeyword & | operator= (QString value) |
Sets new values. | |
void | addValue (QString value, QString unit="") |
Adds a value with units. | |
void | addJsonValue (nlohmann::json jsonobj, QString unit="") |
Adds a value with units. | |
PvlKeyword & | operator+= (QString value) |
Adds a value. | |
int | size () const |
Returns the number of values stored in this keyword. | |
bool | isNull (const int index=0) const |
Decides whether a value is null or not at a given index. | |
void | clear () |
Clears all values and units for this PvlKeyword object. | |
operator double () const | |
Returns the first value in this keyword converted to a double. | |
operator int () const | |
Returns the first value in this keyword converted to an integer. | |
operator Isis::BigInt () const | |
Returns the first value in this keyword converted to a BigInt. | |
operator QString () const | |
const QString & | operator[] (int index) const |
Gets value for this object at specified index. | |
QString & | operator[] (int index) |
Gets value for this object at specified index. | |
QString | unit (const int index=0) const |
Returns the units of measurement of the element of the array of values for the object at the specified index. | |
void | addComment (QString comment) |
Add a comment to the PvlKeyword. | |
void | addCommentWrapped (QString comment) |
Automatically wraps and adds long comments to the PvlKeyword. | |
void | addComments (const std::vector< QString > &comments) |
This method adds multiple comments at once by calling AddComments on each element in the vector. | |
int | comments () const |
Returns the number of lines of comments associated with this keyword. | |
QString | comment (const int index) const |
Return a comment at the specified index. | |
void | clearComment () |
Clears the current comments. | |
bool | operator== (const PvlKeyword &key) const |
Returns true of the keyword names match. | |
bool | operator!= (const PvlKeyword &key) const |
Returns true of the keyword names do not match. | |
bool | isEquivalent (QString string1, int index=0) const |
Checks to see if a value with a specified index is equivalent to another QString. | |
void | setWidth (int width) |
The width of the longest keyword name (for formatting) | |
void | setIndent (int indent) |
Sets the indent level when outputted(for formatting) | |
int | width () const |
Returns the current set longest keyword name. | |
int | indent () const |
Returns the current indent level. | |
PvlKeyword & | operator= (Isis::PvlSequence &seq) |
Add values and units from a PvlSequence. | |
void | setFormat (PvlFormat *formatter) |
Set the PvlFormatter used to format the keyword name and value(s) | |
PvlFormat * | format () |
Get the current PvlFormat or create one. | |
const PvlKeyword & | operator= (const PvlKeyword &other) |
This is an assignment operator. | |
void | validateKeyword (PvlKeyword &pvlKwrd, QString psValueType="", PvlKeyword *pvlKwrdRange=NULL) |
Validate Keyword for type and required values. | |
Static Public Member Functions | |
static bool | stringEqual (const QString &string1, const QString &string2) |
Checks to see if two QStrings are equal. | |
static QString | readLine (std::istream &is, bool insideComment) |
This method reads one line of data from the input stream. | |
static bool | readCleanKeyword (QString keyword, std::vector< QString > &keywordComments, QString &keywordName, std::vector< std::pair< QString, QString > > &keywordValues) |
This reads a keyword compressed back to 1 line of data (excluding comments, which are included on separate lines of data before the keyword). | |
static QString | readValue (QString &keyword, bool "eProblem) |
static QString | readValue (QString &keyword, bool "eProblem, const std::vector< std::pair< char, char > > &otherDelimiters) |
This method looks for a data element in the QString. | |
Protected Member Functions | |
QString | reform (const QString &value) const |
Checks if the value needs to be converted to PVL or iPVL and returns it in the correct format. | |
QString | toPvl (const QString &value) const |
Converts a value to PVL format. | |
QString | toIPvl (const QString &value) const |
Converts a value to iPVL format. | |
std::ostream & | writeWithWrap (std::ostream &os, const QString &textToWrite, int startColumn, PvlFormat &format) const |
Wraps output so that length doesn't exceed the character limit. | |
Protected Attributes | |
PvlFormat * | m_formatter |
Formatter object. | |
Friends | |
std::istream & | operator>> (std::istream &is, PvlKeyword &result) |
Read in a keyword. | |
std::ostream & | operator<< (std::ostream &os, const PvlKeyword &keyword) |
Write out the keyword. | |
A single keyword-value pair.
This class is used to create a single PVL keyword-value pair. PvlContainer can combine PvlKeyword objects and organize them so they look clean on output.
Isis::PvlKeyword::PvlKeyword | ( | ) |
Constructs a blank PvlKeyword object.
Isis::PvlKeyword::PvlKeyword | ( | QString | name | ) |
Constructs a PvlKeyword object with a name.
name | The keyword name |
Isis::PvlKeyword::PvlKeyword | ( | QString | name, |
QString | value, | ||
QString | unit = "" ) |
Constructs a PvlKeyword object with a name, value and units.
Defaults to unit="".
name | The keyword name. |
value | The keyword values. |
unit | The units the values are given in. |
References addValue(), name(), setName(), and unit().
Isis::PvlKeyword::PvlKeyword | ( | const PvlKeyword & | other | ) |
Copy constructor.
Isis::PvlKeyword::~PvlKeyword | ( | ) |
Destructs a PvlKeyword object.
void Isis::PvlKeyword::addComment | ( | QString | comment | ) |
Add a comment to the PvlKeyword.
comment | The new comment. |
References comment().
Referenced by Isis::PvlContainer::addComment(), addComments(), addCommentWrapped(), Isis::fitsToJson(), and Isis::ControlNetVersioner::toPvl().
void Isis::PvlKeyword::addComments | ( | const std::vector< QString > & | comments | ) |
This method adds multiple comments at once by calling AddComments on each element in the vector.
comments | Comments to associate with this keyword |
References addComment(), and comments().
void Isis::PvlKeyword::addCommentWrapped | ( | QString | comment | ) |
Automatically wraps and adds long comments to the PvlKeyword.
comment | The new comment to add |
References addComment(), comment(), and Isis::IString::Token().
void Isis::PvlKeyword::addJsonValue | ( | nlohmann::json | jsonobj, |
QString | unit = "" ) |
Adds a value with units.
If no current value exists, this method sets the given json value. Otherwise, it retains any current values and adds the json value given to the array of values for this PvlKeyword object using addValue. Defaults to unit = "" (empty QString).
jsonobj | New jsonobj to be parsed and assigned. |
unit | Units of measurement corresponding to the value. |
Isis::iException::Unknown | - jsonobj cannot be an array of values |
References _FILEINFO_, addValue(), name(), unit(), and Isis::IException::Unknown.
Referenced by Isis::PvlObject::PvlObject(), and setJsonValue().
void Isis::PvlKeyword::addValue | ( | QString | value, |
QString | unit = "" ) |
Adds a value with units.
If no current value exists, this method sets the given value. Otherwise, it retains any current values and adds the value given to the array of values for this PvlKeyword object. Defaults to unit = "" (empty QString).
value | New value to be assigned. |
unit | Units of measurement corresponding to the value. |
References unit().
Referenced by Isis::DbProfile::add(), addJsonValue(), Isis::ControlNetDiff::addUniqueMeasure(), Isis::ControlNetDiff::addUniquePoint(), Isis::PvlToPvlTranslationManager::DoTranslation(), Isis::HiHistory::makekey(), Isis::ControlNetDiff::makeKeyword(), Isis::ControlNetDiff::makeKeyword(), operator+=(), operator=(), PvlKeyword(), setValue(), and Isis::Spice::storeValue().
void Isis::PvlKeyword::clear | ( | ) |
Clears all values and units for this PvlKeyword object.
Referenced by Isis::PvlFormatPds::formatBinary(), operator=(), operator=(), setJsonValue(), setValue(), and Isis::ProcessExportPds4::StandardAllMapping().
void Isis::PvlKeyword::clearComment | ( | ) |
Clears the current comments.
QString Isis::PvlKeyword::comment | ( | const int | index | ) | const |
Return a comment at the specified index.
index | The index of the comment. |
iException | ArraySubscriptNotInRange (index) Index out of bounds. |
References _FILEINFO_, Isis::Message::ArraySubscriptNotInRange(), and Isis::IException::Programmer.
Referenced by addComment(), addCommentWrapped(), Isis::PvlContainer::comment(), Isis::pvlKeywordToJSON(), and readCleanKeyword().
|
inline |
Returns the number of lines of comments associated with this keyword.
Referenced by addComments(), Isis::PvlContainer::comments(), Isis::pvlKeywordToJSON(), and readCleanKeyword().
PvlFormat * Isis::PvlKeyword::format | ( | ) |
Get the current PvlFormat or create one.
References m_formatter.
Referenced by Isis::PvlContainer::format(), and writeWithWrap().
|
inline |
Returns the current indent level.
Referenced by Isis::PvlContainer::indent(), and setIndent().
bool Isis::PvlKeyword::isEquivalent | ( | QString | QString1, |
int | index = 0 ) const |
Checks to see if a value with a specified index is equivalent to another QString.
QString1 | The QString to compare the value to. |
index | The index of the existing value. |
iException | ArraySubscriptNotInRange (index) Index out of bounds. |
References _FILEINFO_, Isis::Message::ArraySubscriptNotInRange(), Isis::IException::Programmer, and stringEqual().
|
inline |
Determines whether two PvlKeywords have the same name or not.
name | The name of the keyword to compare with this one. |
References name(), and stringEqual().
Referenced by Isis::KernelDb::findAll(), and Isis::KernelDb::matches().
bool Isis::PvlKeyword::isNull | ( | const int | index = 0 | ) | const |
Decides whether a value is null or not at a given index.
Defaults to index = 0.
index | The value index |
References _FILEINFO_, Isis::Message::ArraySubscriptNotInRange(), Isis::IException::Programmer, size(), and stringEqual().
|
inline |
Returns the keyword name.
Referenced by Isis::PvlFormat::accuracy(), Isis::PvlFlatMap::add(), Isis::PvlFormat::add(), addJsonValue(), Isis::PvlContainer::addKeyword(), Isis::PvlTranslationTable::AddTable(), Isis::PvlFlatMap::append(), Isis::UserInterface::BuildNewCommandLineFromPvl(), Isis::Strategy::composite(), Isis::fitsToJson(), Isis::PvlFormat::formatName(), Isis::PvlFormatPds::formatName(), Isis::PvlFormatPds::formatValue(), isNamed(), Isis::PvlContainer::operator-=(), PvlKeyword(), PvlKeyword(), setName(), Isis::PvlContainer::type(), Isis::PvlFormat::type(), Isis::PvlContainer::validateAllKeywords(), validateKeyword(), and Isis::PvlContainer::validateRepeatOption().
|
inline |
Returns the first value in this keyword converted to a double.
References Isis::toDouble().
|
inline |
Returns the first value in this keyword converted to an integer.
References Isis::toInt().
|
inline |
Returns the first value in this keyword converted to a BigInt.
References Isis::toBigInt().
Isis::PvlKeyword::operator QString | ( | ) | const |
|
inline |
Returns true of the keyword names do not match.
key | The keyword to compare names with |
PvlKeyword & Isis::PvlKeyword::operator+= | ( | QString | value | ) |
Adds a value.
Overwrites the '+=' operators to add a new value. Like addValue(), this method keeps any previously existing values and adds the new value with unit = "" (empty QString) to the array of values for this PvlKeyword object.
value | The new value. |
References addValue().
Referenced by operator=().
const PvlKeyword & Isis::PvlKeyword::operator= | ( | const PvlKeyword & | other | ) |
This is an assignment operator.
References m_formatter, and setName().
PvlKeyword & Isis::PvlKeyword::operator= | ( | Isis::PvlSequence & | seq | ) |
Add values and units from a PvlSequence.
(Clears current values and units)
seq | The PvlSequence to add from. |
References clear(), operator+=(), and size().
PvlKeyword & Isis::PvlKeyword::operator= | ( | QString | value | ) |
Sets new values.
Overwrites the '=' operator to add a new value using addValue(). Like setValue(), this method clears any previously existing values and resets to the given value with unit = "" (empty QString).
value | The value to be added. |
References addValue(), and clear().
|
inline |
Returns true of the keyword names match.
key | The keyword to compare names with |
References stringEqual().
QString & Isis::PvlKeyword::operator[] | ( | int | index | ) |
Gets value for this object at specified index.
Overrides the '[]' operator to return the element in the array of values at the specified index.
index | The index of the value. |
iException | ArraySubscriptNotInRange (index) Index out of bounds. |
References _FILEINFO_, Isis::Message::ArraySubscriptNotInRange(), and Isis::IException::Programmer.
const QString & Isis::PvlKeyword::operator[] | ( | int | index | ) | const |
Gets value for this object at specified index.
Overrides the '[]' operator to return the element in the array of values at the specified index.
index | The index of the value. |
iException | ArraySubscriptNotInRange (index) Index out of bounds. |
References _FILEINFO_, Isis::Message::ArraySubscriptNotInRange(), and Isis::IException::Programmer.
|
static |
This reads a keyword compressed back to 1 line of data (excluding comments, which are included on separate lines of data before the keyword).
Line concatenations must have already been handled. This returns the data of the keyword (if valid) and its status.
keyword | Pvl "#COMMENT\n//COMMENT\nKeyword = (Value1,Value2,...)" QString |
keywordComments | Output: Lines of data that are comments |
keywordName | Output: Name of keyword |
keywordValues | Output: vector< pair<Value, Units> > |
References _FILEINFO_, comment(), comments(), readValue(), and Isis::IException::Unknown.
|
static |
This method reads one line of data from the input stream.
All spaces, newlines, returns and tabs are trimmed from the result. Once a newline is encountered, if the line we read is blank, we keep reading. Once a line with data is encountered, that is the result. All newlines, spaces, returns and tabs are consumed past this line of data until the next different character (seeks to next valid data).
is | The stream to read from |
|
static |
References readValue().
Referenced by readCleanKeyword(), and readValue().
|
static |
This method looks for a data element in the QString.
A data element is a quoted QString, a units value, or one value of an array (not including units). As an example, each value in the following QString is quoted:
'VALUE' '=' ('VALUE','VALUE', 'VALUE' '
')
The returned values of each of these elements is VALUE. Explicitly defined quotes (', ", <>) are stripped from the return value.
keyword | Input/Output: The keyword to get the next value from (DESTRUCTIVE) |
quoteProblem | Output: The QString has an unclosed quote character |
|
protected |
Checks if the value needs to be converted to PVL or iPVL and returns it in the correct format.
value | The value to be converted. |
References Isis::Preference::Preferences(), toIPvl(), toPvl(), Isis::PvlObject::Traverse, and Isis::IString::UpCase().
void Isis::PvlKeyword::setFormat | ( | PvlFormat * | formatter | ) |
Set the PvlFormatter used to format the keyword name and value(s)
formatter | A pointer to the formatter to be used |
References m_formatter.
Referenced by Isis::PvlContainer::setFormat().
|
inline |
Sets the indent level when outputted(for formatting)
indent | The new indent |
References indent().
Referenced by Isis::PvlContainer::setIndent().
void Isis::PvlKeyword::setJsonValue | ( | nlohmann::json | jsonobj, |
QString | unit = "" ) |
Sets new value from Json.
If no current value exists, this method sets the given json value to the PvlKeyword. Otherwise, it clears any existing values and resets to the value given using addJsonValue(). Defaults to unit = "" (empty QString).
jsonobj | New jsobobj to be parsed and assigned. |
unit | Units of measurement corresponding to the value. |
References addJsonValue(), clear(), and unit().
Referenced by Isis::PvlObject::PvlObject().
void Isis::PvlKeyword::setName | ( | QString | name | ) |
Sets the keyword name.
name | The new keyword name. |
References _FILEINFO_, name(), and Isis::IException::User.
Referenced by Isis::Strategy::composite(), Isis::PvlToPvlTranslationManager::DoTranslation(), Isis::fitsToJson(), operator=(), Isis::PvlContainer::PvlContainer(), Isis::PvlContainer::PvlContainer(), PvlKeyword(), PvlKeyword(), and Isis::PvlObject::PvlObject().
void Isis::PvlKeyword::setUnits | ( | QString | units | ) |
Sets the unit of measure for all current values if any exist.
units | New units to be assigned. |
Referenced by Isis::fitsToJson().
void Isis::PvlKeyword::setUnits | ( | QString | value, |
QString | units ) |
Sets the unit of measure for a given value.
value | The value to match |
units | New units to be assigned. |
Isis::iException::Programmer | - Given value must exist |
References _FILEINFO_, and Isis::IException::Programmer.
void Isis::PvlKeyword::setValue | ( | QString | value, |
QString | unit = "" ) |
Sets new values.
If no current value exists, this method sets the given value to the PvlKeyword. Otherwise, it clears any existing values and resets to the value given using addValue(). Defaults to unit = "" (empty QString).
value | New value to be assigned. |
unit | Units of measurement corresponding to the value. |
References addValue(), clear(), and unit().
Referenced by Isis::PvlContainer::setName(), and Isis::ProcessExportPds::StandardAllMapping().
|
inline |
The width of the longest keyword name (for formatting)
width | the new width |
References width().
|
inline |
Returns the number of values stored in this keyword.
Referenced by Isis::PvlFormat::accuracy(), Isis::PvlFormat::add(), Isis::PvlFlatMap::append(), Isis::DbProfile::count(), Isis::PvlFormatPds::formatBinary(), Isis::PvlFormatPds::formatBool(), Isis::PvlFormatPds::formatEnum(), Isis::PvlFormatPds::formatHex(), Isis::PvlFormatPds::formatInteger(), Isis::PvlFormatPds::formatReal(), Isis::PvlFormatPds::formatString(), Isis::PvlFormatPds::formatUnknown(), Isis::PvlFormat::formatValue(), Isis::Spice::hasKernels(), Isis::PvlTranslationTable::InputGroup(), isNull(), Isis::PvlFormat::isSingleUnit(), Isis::PvlFlatMap::keywordValues(), Isis::LroWideAngleCamera::LroWideAngleCamera(), Isis::KernelDb::matches(), Isis::PvlSequence::operator+=(), operator=(), Isis::PvlSequence::operator=(), Isis::pvlKeywordToJSON(), Isis::ProcessExportPds4::translateBandBinSpectrumBinSet(), and Isis::ProcessExportPds4::translateBandBinSpectrumUniform().
|
static |
Checks to see if two QStrings are equal.
Each is converted to uppercase and removed of underscores and whitespaces.
QString1 | The first QString |
QString2 | The second QString |
Referenced by Isis::PvlToPvlTranslationManager::GetContainer(), Isis::PvlToXmlTranslationManager::GetContainer(), isEquivalent(), Isis::PvlContainer::isNamed(), isNamed(), isNull(), Isis::PvlFormat::isSingleUnit(), Isis::PvlGroup::operator==(), operator==(), and Isis::PvlObject::operator==().
|
protected |
Converts a value to iPVL format.
value | The value to be converted. |
Referenced by reform().
|
protected |
Converts a value to PVL format.
value | The value to be converted. |
Referenced by reform().
QString Isis::PvlKeyword::unit | ( | const int | index = 0 | ) | const |
Returns the units of measurement of the element of the array of values for the object at the specified index.
Defaults to index = 0.
index | The index of the unit. |
iException | ArraySubscriptNotInRange (index) Index out of bounds. |
References _FILEINFO_, Isis::Message::ArraySubscriptNotInRange(), and Isis::IException::Programmer.
Referenced by addJsonValue(), addValue(), Isis::PvlFormatPds::formatBinary(), Isis::PvlFormatPds::formatEnum(), Isis::PvlFormatPds::formatHex(), Isis::PvlFormatPds::formatInteger(), Isis::PvlFormatPds::formatReal(), Isis::PvlFormatPds::formatString(), Isis::PvlFormatPds::formatUnknown(), Isis::PvlFormat::formatValue(), Isis::PvlFormat::isSingleUnit(), PvlKeyword(), Isis::pvlKeywordToJSON(), setJsonValue(), setValue(), Isis::ProcessExportPds::StandardAllMapping(), and Isis::ProcessExportPds4::translateBandBinSpectrumUniform().
void Isis::PvlKeyword::validateKeyword | ( | PvlKeyword & | pvlKwrd, |
QString | psValueType = "", | ||
PvlKeyword * | pvlKwrdValue = NULL ) |
Validate Keyword for type and required values.
Validate a Keyword, comparing against corresponding Template Keyword.
Template Keyword has the format: keyName = (valueType, optional/required, Values allowed separated by comma)
pvlKwrd | - Keyword to be validated |
psValueType | - Value Type (positive / negative) for numbers |
pvlKwrdValue | - Template Keyword __Value or __Range to validate keyword's value |
References _FILEINFO_, name(), Isis::toDouble(), Isis::toInt(), and Isis::IException::User.
|
inline |
Returns the current set longest keyword name.
Referenced by setWidth().
|
protected |
Wraps output so that length doesn't exceed the character limit.
By default, the character limit is set to 80, and can be changed with the method SetCharLimit. Used as a helper method for output of PvlKeyword.
os | Designated output stream |
textToWrite | The text to be written |
startColumn | The starting column after the "=" sign. |
endOfLine | The EOL character |
References Isis::PvlFormat::charLimit(), format(), and Isis::PvlFormat::formatEOL().
|
friend |
Write out the keyword.
os | The output stream. |
keyword | The PvlKeyword object to output. |
|
friend |
Read in a keyword.
http://pds.jpl.nasa.gov/tools/standards-reference.shtml
is | The input stream |
result | The keyword to read into (OUTPUT) |
|
protected |
Formatter object.
Referenced by format(), operator=(), and setFormat().