|
|
| FileIo (const std::string &path) |
| Constructor that accepts the file path on which IO will be performed. The constructor does not open the file, and therefore never fails. More...
|
|
| ~FileIo () override |
| Destructor. Flushes and closes an open file.
|
|
|
int | open (const std::string &mode) |
| Open the file using the specified mode. More...
|
|
int | open () override |
| Open the file using the default access mode of "rb". This method can also be used to "reopen" a file which will flush any unwritten data and reset the IO position to the start. More...
|
|
int | close () override |
| Flush and unwritten data and close the file . It is safe to call close on an already closed instance. More...
|
|
size_t | write (const byte *data, size_t wcount) override |
| Write data to the file. The file position is advanced by the number of bytes written. More...
|
|
size_t | write (BasicIo &src) override |
| Write data that is read from another BasicIo instance to the file. The file position is advanced by the number of bytes written. More...
|
|
int | putb (byte data) override |
| Write one byte to the file. The file position is advanced by one byte. More...
|
|
DataBuf | read (size_t rcount) override |
| Read data from the file. Reading starts at the current file position and the position is advanced by the number of bytes read. More...
|
|
size_t | read (byte *buf, size_t rcount) override |
| Read data from the file. Reading starts at the current file position and the position is advanced by the number of bytes read. More...
|
|
int | getb () override |
| Read one byte from the file. The file position is advanced by one byte. More...
|
|
void | transfer (BasicIo &src) override |
| Remove the contents of the file and then transfer data from the src BasicIo object into the empty file. More...
|
|
int | seek (int64_t offset, Position pos) override |
| Move the current IO position. More...
|
|
byte * | mmap (bool isWriteable=false) override |
| Map the file into the process's address space. The file must be open before mmap() is called. If the mapped area is writeable, changes may not be written back to the underlying file until munmap() is called. The pointer is valid only as long as the FileIo object exists. More...
|
|
int | munmap () override |
| Remove a mapping established with mmap(). If the mapped area is writeable, this ensures that changes are written back to the underlying file. More...
|
|
virtual void | setPath (const std::string &path) |
| close the file source and set a new path.
|
|
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. More...
|
|
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. More...
|
|
|
size_t | tell () const override |
| Get the current file position. More...
|
|
size_t | size () const override |
| Flush any buffered writes and get the current file size in bytes. More...
|
|
bool | isopen () const override |
| Returns true if the file is open, otherwise false.
|
|
int | error () const override |
| Returns 0 if the file is in a valid state, otherwise nonzero.
|
|
bool | eof () const override |
| Returns true if the file position has reached the end, otherwise false.
|
|
const std::string & | path () const noexcept override |
| Returns the path of the file.
|
|
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) More...
|
|
| FileIo (const FileIo &)=delete |
| Copy constructor.
|
|
FileIo & | operator= (const FileIo &)=delete |
| Assignment operator.
|
|
Provides binary file IO by implementing the BasicIo interface.
- Examples
- metacopy.cpp, and mrwthumb.cpp.
void Exiv2::FileIo::transfer |
( |
BasicIo & |
src | ) |
|
|
overridevirtual |
Remove the contents of the file and then transfer data from the src BasicIo object into the empty file.
This method is optimized to simply rename the source file if the source object is another FileIo instance. The source BasicIo object 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.
- Note
- If the caller doesn't have permissions to write to the file, an exception is raised and src is deleted.
- Parameters
-
src | Reference to another BasicIo instance. The entire contents of src are transferred to this object. The src object is invalidated by the method. |
- Exceptions
-
Implements Exiv2::BasicIo.
Reimplemented in Exiv2::XPathIo.