Main MRPT website > C++ reference for MRPT 1.9.9
List of all members | Public Types | Public Member Functions | Private Attributes
mrpt::io::CFileGZInputStream Class Reference

Detailed Description

Transparently opens a compressed "gz" file and reads uncompressed data from it.

If the file is not a .gz file, it silently reads data from the file. This class requires compiling MRPT with wxWidgets. If wxWidgets is not available then the class is actually mapped to the standard CFileInputStream

See also
CFileInputStream

Definition at line 26 of file io/CFileGZInputStream.h.

#include <mrpt/io/CFileGZInputStream.h>

Inheritance diagram for mrpt::io::CFileGZInputStream:
Inheritance graph

Public Types

enum  TSeekOrigin { sFromBeginning = 0, sFromCurrent = 1, sFromEnd = 2 }
 Used in CStream::Seek. More...
 

Public Member Functions

 CFileGZInputStream ()
 Constructor without open. More...
 
 CFileGZInputStream (const std::string &fileName)
 Constructor and open. More...
 
 CFileGZInputStream (const CFileGZInputStream &)=delete
 
CFileGZInputStreamoperator= (const CFileGZInputStream &)=delete
 
virtual ~CFileGZInputStream ()
 Dtor. More...
 
bool open (const std::string &fileName)
 Opens the file for read. More...
 
void close ()
 Closes the file. More...
 
bool fileOpenCorrectly () const
 Returns true if the file was open without errors. More...
 
bool is_open ()
 Returns true if the file was open without errors. More...
 
bool checkEOF ()
 Will be true if EOF has been already reached. More...
 
uint64_t getTotalBytesCount () const override
 Method for getting the total number of compressed bytes of in the file (the physical size of the compressed file). More...
 
uint64_t getPosition () const override
 Method for getting the current cursor position in the compressed, where 0 is the first byte and TotalBytesCount-1 the last one. More...
 
uint64_t Seek (int64_t, CStream::TSeekOrigin=sFromBeginning) override
 This method is not implemented in this class. More...
 
size_t Read (void *Buffer, size_t Count) override
 Introduces a pure virtual method responsible for reading from the stream. More...
 
size_t Write (const void *Buffer, size_t Count) override
 Introduces a pure virtual method responsible for writing to the stream. More...
 
virtual size_t ReadBufferImmediate (void *Buffer, size_t Count)
 Reads a block of bytes from the stream into Buffer, and returns the amound of bytes actually read, without waiting for more extra bytes to arrive (just those already enqued in the stream). More...
 
virtual int printf (const char *fmt,...) MRPT_printf_format_check(2
 Writes a string to the stream in a textual form. More...
 
template<typename CONTAINER_TYPE >
virtual int void printf_vector (const char *fmt, const CONTAINER_TYPE &V, char separator=',')
 Prints a vector in the format [A,B,C,...] using CStream::printf, and the fmt string for each vector element T. More...
 
bool getline (std::string &out_str)
 Reads from the stream until a '
' character is found ('' characters are ignored). More...
 

Private Attributes

voidm_f
 
uint64_t m_file_size
 Compressed file size. More...
 

Member Enumeration Documentation

◆ TSeekOrigin

Used in CStream::Seek.

Enumerator
sFromBeginning 
sFromCurrent 
sFromEnd 

Definition at line 34 of file io/CStream.h.

Constructor & Destructor Documentation

◆ CFileGZInputStream() [1/3]

CFileGZInputStream::CFileGZInputStream ( )

Constructor without open.

Definition at line 35 of file CFileGZInputStream.cpp.

◆ CFileGZInputStream() [2/3]

CFileGZInputStream::CFileGZInputStream ( const std::string fileName)

Constructor and open.

Parameters
fileNameThe file to be open in this stream
Exceptions
std::exceptionIf there's an error opening the file.

Definition at line 28 of file CFileGZInputStream.cpp.

References MRPT_END, MRPT_START, and open().

◆ CFileGZInputStream() [3/3]

mrpt::io::CFileGZInputStream::CFileGZInputStream ( const CFileGZInputStream )
delete

◆ ~CFileGZInputStream()

CFileGZInputStream::~CFileGZInputStream ( )
virtual

Dtor.

Definition at line 63 of file CFileGZInputStream.cpp.

References close().

Member Function Documentation

◆ checkEOF()

bool CFileGZInputStream::checkEOF ( )

Will be true if EOF has been already reached.

Definition at line 100 of file CFileGZInputStream.cpp.

References m_f, and THE_GZFILE.

◆ close()

void CFileGZInputStream::close ( )

Closes the file.

Definition at line 54 of file CFileGZInputStream.cpp.

References m_f, and THE_GZFILE.

Referenced by mrpt::pbmap::PbMap::loadPbMap(), and ~CFileGZInputStream().

◆ fileOpenCorrectly()

bool CFileGZInputStream::fileOpenCorrectly ( ) const

◆ getline()

bool CStream::getline ( std::string out_str)
inherited

Reads from the stream until a '
' character is found ('' characters are ignored).

Returns
false on EOF or any other read error.

Definition at line 69 of file CStream.cpp.

◆ getPosition()

uint64_t CFileGZInputStream::getPosition ( ) const
overridevirtual

Method for getting the current cursor position in the compressed, where 0 is the first byte and TotalBytesCount-1 the last one.

Implements mrpt::io::CStream.

Definition at line 90 of file CFileGZInputStream.cpp.

References m_f, THE_GZFILE, and THROW_EXCEPTION.

◆ getTotalBytesCount()

uint64_t CFileGZInputStream::getTotalBytesCount ( ) const
overridevirtual

Method for getting the total number of compressed bytes of in the file (the physical size of the compressed file).

Implements mrpt::io::CStream.

Definition at line 81 of file CFileGZInputStream.cpp.

References m_f, m_file_size, and THROW_EXCEPTION.

Referenced by mrpt::io::zip::decompress_gz_file().

◆ is_open()

bool mrpt::io::CFileGZInputStream::is_open ( )
inline

Returns true if the file was open without errors.

Definition at line 59 of file io/CFileGZInputStream.h.

References fileOpenCorrectly().

◆ open()

bool CFileGZInputStream::open ( const std::string fileName)

Opens the file for read.

Parameters
fileNameThe file to be open in this stream
Returns
false if there's an error opening the file, true otherwise

Definition at line 36 of file CFileGZInputStream.cpp.

References mrpt::system::getFileSize(), m_f, m_file_size, MRPT_END, MRPT_START, THE_GZFILE, and THROW_EXCEPTION_FMT.

Referenced by CFileGZInputStream(), and mrpt::pbmap::PbMap::loadPbMap().

◆ operator=()

CFileGZInputStream& mrpt::io::CFileGZInputStream::operator= ( const CFileGZInputStream )
delete

◆ printf()

int CStream::printf ( const char *  fmt,
  ... 
)
virtualinherited

Writes a string to the stream in a textual form.

See also
CStdOutStream

Definition at line 30 of file CStream.cpp.

References MRPT_END, MRPT_START, and vsnprintf.

Referenced by mrpt::hmtslam::CTopLCDetector_GridMatching::computeTopologicalObservationModel(), and mrpt::io::CStream::printf_vector().

◆ printf_vector()

template<typename CONTAINER_TYPE >
virtual int void mrpt::io::CStream::printf_vector ( const char *  fmt,
const CONTAINER_TYPE &  V,
char  separator = ',' 
)
inlineinherited

Prints a vector in the format [A,B,C,...] using CStream::printf, and the fmt string for each vector element T.

Template Parameters
CONTAINER_TYPEcan be any vector<T>, deque<T> or alike.

Definition at line 104 of file io/CStream.h.

References mrpt::io::CStream::printf().

Referenced by mrpt::hmtslam::CTopLCDetector_GridMatching::computeTopologicalObservationModel().

◆ Read()

size_t CFileGZInputStream::Read ( void Buffer,
size_t  Count 
)
overridevirtual

Introduces a pure virtual method responsible for reading from the stream.

Implements mrpt::io::CStream.

Definition at line 64 of file CFileGZInputStream.cpp.

References m_f, THE_GZFILE, and THROW_EXCEPTION.

Referenced by mrpt::io::zip::decompress_gz_file().

◆ ReadBufferImmediate()

virtual size_t mrpt::io::CStream::ReadBufferImmediate ( void Buffer,
size_t  Count 
)
inlinevirtualinherited

Reads a block of bytes from the stream into Buffer, and returns the amound of bytes actually read, without waiting for more extra bytes to arrive (just those already enqued in the stream).

Note that this method will fallback to ReadBuffer() in most CStream classes but in some hardware-related classes.

Exceptions
std::exceptionOn any error, or if ZERO bytes are read.

Reimplemented in mrpt::comms::CInterfaceFTDI.

Definition at line 64 of file io/CStream.h.

References mrpt::io::CStream::Read().

◆ Seek()

uint64_t CFileGZInputStream::Seek ( int64_t  ,
CStream::TSeekOrigin  = sFromBeginning 
)
overridevirtual

This method is not implemented in this class.

Implements mrpt::io::CStream.

Definition at line 108 of file CFileGZInputStream.cpp.

References THROW_EXCEPTION.

◆ Write()

size_t CFileGZInputStream::Write ( const void Buffer,
size_t  Count 
)
overridevirtual

Introduces a pure virtual method responsible for writing to the stream.

Write attempts to write up to Count bytes to Buffer, and returns the number of bytes actually written.

Implements mrpt::io::CStream.

Definition at line 74 of file CFileGZInputStream.cpp.

References MRPT_UNUSED_PARAM, and THROW_EXCEPTION.

Member Data Documentation

◆ m_f

void* mrpt::io::CFileGZInputStream::m_f
private

◆ m_file_size

uint64_t mrpt::io::CFileGZInputStream::m_file_size
private

Compressed file size.

Definition at line 31 of file io/CFileGZInputStream.h.

Referenced by getTotalBytesCount(), and open().




Page generated by Doxygen 1.8.14 for MRPT 1.9.9 Git: ad3a9d8ae Tue May 1 23:10:22 2018 -0700 at lun oct 28 00:14:14 CET 2019