Isis 3 Developer Reference
Isis::History Class Reference

#include <History.h>

Inheritance diagram for Isis::History:
Inheritance graph
Collaboration diagram for Isis::History:
Collaboration graph

Public Member Functions

 History (const QString &name)
 Constructor for reading a history blob. More...
 
 History (const QString &name, const QString &file)
 Constructor for reading a history blob. More...
 
 ~History ()
 Destructor. More...
 
void AddEntry ()
 Adds History PvlObject. More...
 
void AddEntry (Isis::PvlObject &obj)
 Adds given PvlObject to History Pvl. More...
 
Pvl ReturnHist ()
 Reads p_buffer into a pvl. More...
 
void Read (const Isis::Pvl &pvl, std::istream &is)
 Reads input stream into Pvl. More...
 
QString Type () const
 Accessor method that returns a string containing the Blob type. More...
 
QString Name () const
 Accessor method that returns a string containing the Blob name. More...
 
int Size () const
 Accessor method that returns the number of bytes in the blob data. More...
 
PvlObjectLabel ()
 Accessor method that returns a PvlObject containing the Blob label. More...
 
void Read (const QString &file)
 This method reads Pvl values from a specified file. More...
 
void Read (const QString &file, const Pvl &pvlLabels)
 This method reads the given a file and labels. More...
 
void Write (const QString &file)
 Write the blob data out to a file. More...
 
void Write (Pvl &pvl, std::fstream &stm, const QString &detachedFileName="")
 Write the blob data out to a Pvl object. More...
 

Protected Member Functions

void WriteInit ()
 This virtual method for classes that inherit Blob. More...
 
void Find (const Pvl &pvl)
 This method searches the given Pvl for the Blob by the Blob's type and name. More...
 
virtual void ReadInit ()
 This virtual method for classes that inherit Blob. More...
 
virtual void ReadData (std::istream &is)
 Read binary data from an input stream into the Blob object. More...
 
virtual void WriteData (std::fstream &os)
 Writes blob data to a stream. More...
 

Protected Attributes

PvlObject p_blobPvl
 Pvl Blob object. More...
 
QString p_blobName
 Name of the Blob object. More...
 
char * p_buffer
 Buffer blob data is stored in. More...
 
BigInt p_startByte
 Byte blob data starts at in buffer. More...
 
int p_nbytes
 Size of blob data (in bytes) More...
 
QString p_type
 Type of data stored in the buffer. More...
 
QString p_detached
 Used for reading detached blobs. More...
 
QString p_labelFile
 The file containing the labels. More...
 

Detailed Description

Author
????-??-?? Unknown

Constructor & Destructor Documentation

◆ History() [1/2]

Isis::History::History ( const QString &  name)

Constructor for reading a history blob.

Parameters
name

References Isis::Pvl::setTerminator().

◆ History() [2/2]

Isis::History::History ( const QString &  name,
const QString &  file 
)

Constructor for reading a history blob.

Parameters
name
file

References Isis::Blob::Read().

◆ ~History()

Isis::History::~History ( )

Destructor.

Member Function Documentation

◆ AddEntry() [1/2]

void Isis::History::AddEntry ( )

◆ AddEntry() [2/2]

void Isis::History::AddEntry ( Isis::PvlObject obj)

Adds given PvlObject to History Pvl.

Parameters
objPvlObject to be added

References Isis::PvlObject::addObject().

◆ Find()

void Isis::Blob::Find ( const Pvl pvl)
protectedinherited

This method searches the given Pvl for the Blob by the Blob's type and name.

If found, the start byte, number of bytes are read from the Pvl. Also, if a keyword label pointer is found, the filename for the detached blob is stored and the pointer is removed from the blob pvl.

Parameters
pvlThe Pvl to be searched

References _FILEINFO_, Isis::PvlContainer::isNamed(), Isis::PvlObject::object(), Isis::PvlObject::objects(), and Isis::FileName::path().

◆ Label()

PvlObject & Isis::Blob::Label ( )
inherited

Accessor method that returns a PvlObject containing the Blob label.

Returns
PvlObject The label of the blob.

Referenced by Isis::SpiceRotation::CacheLabel(), Isis::SpicePosition::LoadCache(), and Isis::SpiceRotation::LoadCache().

◆ Name()

QString Isis::Blob::Name ( ) const
inherited

Accessor method that returns a string containing the Blob name.

Returns
string The name of the blob.

Referenced by Isis::Shape::isFootprintable(), Isis::Image::isFootprintable(), Isis::SpicePosition::LoadCache(), and Isis::Cube::write().

◆ Read() [1/3]

void Isis::History::Read ( const Isis::Pvl pvl,
std::istream &  is 
)
virtual

Reads input stream into Pvl.

Parameters
pvlPvl into which the input stream will be read.
isInput stream.

Reimplemented from Isis::Blob.

References Isis::Blob::Read().

◆ Read() [2/3]

void Isis::Blob::Read ( const QString &  file)
inherited

This method reads Pvl values from a specified file.

Parameters
fileThe filename to read from.
Exceptions
iException::Io- Unable to open file
iException::Pvl- Invalid label format

References _FILEINFO_, and Isis::Pvl::read().

Referenced by History(), Isis::OriginalLabel::OriginalLabel(), Isis::OriginalXmlLabel::OriginalXmlLabel(), Read(), Isis::Cube::read(), and Isis::Table::Table().

◆ Read() [3/3]

void Isis::Blob::Read ( const QString &  file,
const Pvl pvlLabels 
)
inherited

This method reads the given a file and labels.

Parameters
fileThe filename to read from.
pvlLabelsA Pvl containing the label information.
Exceptions
iException::Io- Unable to open file

References _FILEINFO_, and Isis::Message::FileOpen().

◆ ReadData()

void Isis::Blob::ReadData ( std::istream &  stream)
protectedvirtualinherited

Read binary data from an input stream into the Blob object.

Parameters
streamThe input stream to read from.
Exceptions
IException::Io- Error reading data from stream

Reimplemented in Isis::ImagePolygon, Isis::Table, and Isis::OriginalXmlLabel.

References _FILEINFO_.

Referenced by Isis::OriginalXmlLabel::ReadData().

◆ ReadInit()

void Isis::Blob::ReadInit ( )
protectedvirtualinherited

This virtual method for classes that inherit Blob.

It is not defined in the Blob class.

Reimplemented in Isis::Table.

◆ ReturnHist()

Pvl Isis::History::ReturnHist ( )

Reads p_buffer into a pvl.

Returns
Pvl

References Isis::Blob::p_buffer, and Isis::Blob::p_nbytes.

◆ Size()

int Isis::Blob::Size ( ) const
inherited

Accessor method that returns the number of bytes in the blob data.

Returns
int Number of bytes in the blob data.

◆ Type()

QString Isis::Blob::Type ( ) const
inherited

Accessor method that returns a string containing the Blob type.

Returns
string Type of blob.

Referenced by Isis::Shape::isFootprintable(), Isis::Image::isFootprintable(), and Isis::Cube::write().

◆ Write() [1/2]

void Isis::Blob::Write ( const QString &  file)
inherited

Write the blob data out to a file.

Parameters
fileThe filename to write to.
Exceptions
IException::Io- Unable to open file
IException::Io- Error preparing to write data to file
IException::Io- Error creating file

References _FILEINFO_, Isis::PvlObject::addObject(), Isis::PvlObject::findObject(), Isis::toString(), and Isis::Pvl::write().

Referenced by Isis::Cube::write().

◆ Write() [2/2]

void Isis::Blob::Write ( Pvl pvl,
std::fstream &  stm,
const QString &  detachedFileName = "" 
)
inherited

Write the blob data out to a Pvl object.

Parameters
pvlThe pvl object to update
stmstream to write data to
detachedFileNameIf the stream is detached from the labels give the name of the file

References Isis::PvlObject::addObject(), Isis::PvlContainer::name(), Isis::PvlObject::object(), Isis::PvlObject::objects(), and Isis::toString().

◆ WriteData()

void Isis::Blob::WriteData ( std::fstream &  stream)
protectedvirtualinherited

Writes blob data to a stream.

Parameters
streamOutput steam blob data will be written to
Exceptions
IException::Io- Error writing data to stream

Reimplemented in Isis::ImagePolygon, Isis::Table, and Isis::OriginalXmlLabel.

References _FILEINFO_.

◆ WriteInit()

void Isis::History::WriteInit ( )
protectedvirtual

This virtual method for classes that inherit Blob.

It is not defined in the Blob class.

Reimplemented from Isis::Blob.

References Isis::Blob::p_buffer, and Isis::Blob::p_nbytes.

Member Data Documentation

◆ p_blobName

QString Isis::Blob::p_blobName
protectedinherited

◆ p_blobPvl

◆ p_buffer

◆ p_detached

QString Isis::Blob::p_detached
protectedinherited

Used for reading detached blobs.

Referenced by Isis::Blob::Blob(), and Isis::Blob::operator=().

◆ p_labelFile

QString Isis::Blob::p_labelFile
protectedinherited

The file containing the labels.

Referenced by Isis::Blob::Blob(), and Isis::Blob::operator=().

◆ p_nbytes

◆ p_startByte

BigInt Isis::Blob::p_startByte
protectedinherited

Byte blob data starts at in buffer.

Referenced by Isis::Blob::Blob(), Isis::Blob::operator=(), Isis::Table::ReadData(), and Isis::ImagePolygon::ReadData().

◆ p_type

QString Isis::Blob::p_type
protectedinherited

Type of data stored in the buffer.

Referenced by Isis::Blob::Blob(), Isis::Blob::operator=(), and Isis::ImagePolygon::ReadData().


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