Provides binary IO on blocks of memory by implementing the BasicIo interface. A copy-on-write implementation ensures that the data passed in is only copied when necessary, i.e., as soon as data is written to the MemIo. The original data is only used for reading. If writes are performed, the changed data can be retrieved using the read methods (since the data used in construction is never modified). More...
#include <basicio.hpp>
Public Member Functions | |
Creators | |
MemIo () | |
Default constructor that results in an empty object. | |
MemIo (const byte *data, size_t size) | |
Constructor that accepts a block of memory. A copy-on-write algorithm allows read operations directly from the original data and will create a copy of the buffer on the first write operation. | |
~MemIo () override | |
Destructor. Releases all managed memory. | |
Manipulators | |
int open () override | |
Memory IO is always open for reading and writing. This method therefore only resets the IO position to the start. | |
int close () override | |
Does nothing on MemIo objects. | |
size_t write (const byte *data, size_t wcount) override | |
Write data to the memory block. If needed, the size of the internal memory block is expanded. The IO position is advanced by the number of bytes written. | |
size_t write (BasicIo &src) override | |
Write data that is read from another BasicIo instance to the memory block. If needed, the size of the internal memory block is expanded. The IO position is advanced by the number of bytes written. | |
int putb (byte data) override | |
Write one byte to the memory block. The IO position is advanced by one byte. | |
DataBuf read (size_t rcount) override | |
Read data from the memory block. Reading starts at the current IO position and the position is advanced by the number of bytes read. | |
size_t read (byte *buf, size_t rcount) override | |
Read data from the memory block. Reading starts at the current IO position and the position is advanced by the number of bytes read. | |
int getb () override | |
Read one byte from the memory block. The IO position is advanced by one byte. | |
void transfer (BasicIo &src) override | |
Clear the memory block and then transfer data from the src BasicIo object into a new block of memory. | |
int seek (int64_t offset, Position pos) override | |
Move the current IO position. | |
byte * mmap (bool=false) override | |
Allow direct access to the underlying data buffer. The buffer is not protected against write access in any way, the argument is ignored. | |
int munmap () override | |
Remove a mapping established with mmap(). If the mapped area is writeable, this ensures that changes are written back. | |
![]() | |
virtual ~BasicIo ()=default | |
Destructor. | |
void readOrThrow (byte *buf, size_t rcount, ErrorCode err=ErrorCode::kerCorruptedMetadata) | |
Safe version of read() that checks for errors and throws an exception if the read was unsuccessful. | |
void seekOrThrow (int64_t offset, Position pos, ErrorCode err) | |
Safe version of seek() that checks for errors and throws an exception if the seek was unsuccessful. |
Accessors | |
size_t tell () const override | |
Get the current IO position. | |
size_t size () const override | |
Get the current memory buffer size in bytes. | |
bool isopen () const override | |
Always returns true. | |
int error () const override | |
Always returns 0. | |
bool eof () const override | |
Returns true if the IO position has reached the end, otherwise false. | |
const std::string & path () const noexcept override | |
Returns a dummy path, indicating that memory access is used. | |
void populateFakeData () override | |
Mark all the bNone blocks to bKnow. This avoids allocating memory for parts of the file that contain image-date (non-metadata/pixel data) | |
MemIo (const MemIo &)=delete | |
Copy constructor. | |
MemIo & operator= (const MemIo &)=delete | |
Assignment operator. |
Additional Inherited Members | |
![]() | |
enum Position { beg , cur , end } | |
Seek starting positions. | |
using UniquePtr = std::unique_ptr< BasicIo > | |
BasicIo auto_ptr type. | |
![]() | |
byte * bigBlock_ {} | |
this is allocated and populated by mmap() |
Provides binary IO on blocks of memory by implementing the BasicIo interface. A copy-on-write implementation ensures that the data passed in is only copied when necessary, i.e., as soon as data is written to the MemIo. The original data is only used for reading. If writes are performed, the changed data can be retrieved using the read methods (since the data used in construction is never modified).
Exiv2::MemIo::MemIo | ( | const byte * | data, |
size_t | size | ||
) |
Constructor that accepts a block of memory. A copy-on-write algorithm allows read operations directly from the original data and will create a copy of the buffer on the first write operation.
data | Pointer to data. Data must be at least size bytes long |
size | Number of bytes to copy. |
|
overridevirtual |
|
overridevirtual |
Returns true if the IO position has reached the end, otherwise false.
Implements Exiv2::BasicIo.
|
overridevirtual |
Always returns 0.
Implements Exiv2::BasicIo.
|
overridevirtual |
Read one byte from the memory block. The IO position is advanced by one byte.
Implements Exiv2::BasicIo.
|
overridevirtual |
Always returns true.
Implements Exiv2::BasicIo.
|
overridevirtual |
Allow direct access to the underlying data buffer. The buffer is not protected against write access in any way, the argument is ignored.
Implements Exiv2::BasicIo.
|
overridevirtual |
Remove a mapping established with mmap(). If the mapped area is writeable, this ensures that changes are written back.
Implements Exiv2::BasicIo.
|
overridevirtual |
Memory IO is always open for reading and writing. This method therefore only resets the IO position to the start.
Implements Exiv2::BasicIo.
|
overridevirtualnoexcept |
Returns a dummy path, indicating that memory access is used.
Implements Exiv2::BasicIo.
|
overridevirtual |
Mark all the bNone blocks to bKnow. This avoids allocating memory for parts of the file that contain image-date (non-metadata/pixel data)
Implements Exiv2::BasicIo.
|
overridevirtual |
Write one byte to the memory block. The IO position is advanced by one byte.
data | The single byte to be written. |
Implements Exiv2::BasicIo.
|
overridevirtual |
Read data from the memory block. Reading starts at the current IO position and the position is advanced by the number of bytes read.
buf | Pointer to a block of memory into which the read data is stored. The memory block must be at least rcount bytes long. |
rcount | Maximum number of bytes to read. Fewer bytes may be read if rcount bytes are not available. |
Implements Exiv2::BasicIo.
|
overridevirtual |
Read data from the memory block. Reading starts at the current IO position and the position is advanced by the number of bytes read.
rcount | Maximum number of bytes to read. Fewer bytes may be read if rcount bytes are not available. |
Implements Exiv2::BasicIo.
|
overridevirtual |
Move the current IO position.
offset | Number of bytes to move the position relative to the starting position specified by pos |
pos | Position from which the seek should start |
Implements Exiv2::BasicIo.
|
overridevirtual |
Get the current memory buffer size in bytes.
Implements Exiv2::BasicIo.
|
overridevirtual |
Get the current IO position.
Implements Exiv2::BasicIo.
|
overridevirtual |
Clear the memory block and then transfer data from the src BasicIo object into a new block of memory.
This method is optimized to simply swap memory block if the source object is another MemIo instance. The source BasicIo instance is invalidated by this operation and should not be used after this method returns. This method exists primarily to be used with the BasicIo::temporary() method.
src | Reference to another BasicIo instance. The entire contents of src are transferred to this object. The src object is invalidated by the method. |
Error | In case of failure |
Implements Exiv2::BasicIo.
|
overridevirtual |
Write data that is read from another BasicIo instance to the memory block. If needed, the size of the internal memory block is expanded. The IO position is advanced by the number of bytes written.
src | Reference to another BasicIo instance. Reading start at the source's current IO position |
Implements Exiv2::BasicIo.
|
overridevirtual |
Write data to the memory block. If needed, the size of the internal memory block is expanded. The IO position is advanced by the number of bytes written.
data | Pointer to data. Data must be at least wcount bytes long |
wcount | Number of bytes to be written. |
Implements Exiv2::BasicIo.