This concrete class provides a platform independent 'standard' implementation of an InputOutputFileApi object. More...

Detailed Description

This concrete class provides a platform independent 'standard' implementation of an InputOutputFileApi object.

NOTE: All the read/write operations return 'false' if an error occurred, this INCLUDES the end-of-file condition (which is error when dealing with streams). To differentiate between a true error and EOF, the client must call isEof().

#include <InputOutput.h>

Inheritance diagram for Cpl::Io::File::InputOutput:

[legend]

Collaboration diagram for Cpl::Io::File::InputOutput:

[legend]

Public Member Functions
	InputOutput (const char *fileName, bool forceCreate=true, bool forceEmptyFile=false, bool readOnly=false)
	Constructor -->Opens the file (note: readOnly takes precedence over the other flags)

	InputOutput (Cpl::Io::Descriptor streamfd)
	Constructor. 'streamfd' is a the file descriptor of a existing/opened file.

	~InputOutput ()
	Destructor -->Will insure the file gets closed.

bool	isOpened ()
	This method returns true if the Input AND Output streams where successfully open and/or is still opened (i.e.

Cpl::Io::InputOutput &	getStream ()
	See Cpl::Io::File::InputOutputApi.

bool	read (char &c)
	See Cpl::Io::Input.

bool	read (Cpl::Text::String &destString)
	See Cpl::Io::Input.

bool	read (void *buffer, int numBytes, int &bytesRead)
	See Cpl::Io::Input.

bool	available ()
	See Cpl::Io::Input.

bool	write (char c)
	See Cpl::Io::Output.

bool	write (const char *string)
	See Cpl::Io::Output.

bool	write (const Cpl::Text::String &string)
	See Cpl::Io::Output.

bool	write (Cpl::Text::String &formatBuffer, const char *format,...)
	See Cpl::Io::Output.

bool	vwrite (Cpl::Text::String &formatBuffer, const char *format, va_list ap)
	See Cpl::Io::Output.

bool	write (const void *buffer, int maxBytes)
	See Cpl::Io::Output.

bool	write (const void *buffer, int maxBytes, int &bytesWritten)
	See Cpl::Io::Output.

void	flush ()
	See Cpl::Io::Output.

bool	isEos ()
	See Cpl::Io::IsEos (is equivalent to isEof())

void	close ()
	See Cpl::Io::Close.

bool	isEof ()
	See Cpl::Io::File::ObjectApi.

bool	length (unsigned long &len)
	See Cpl::Io::File::ObjectApi.

bool	currentPos (unsigned long &curPosition)
	See Cpl::Io::File::ObjectApi.

bool	setRelativePos (long deltaOffset)
	See Cpl::Io::File::ObjectApi.

bool	setAbsolutePos (unsigned long newoffset)
	See Cpl::Io::File::ObjectApi.

bool	setToEof ()
	See Cpl::Io::File::ObjectApi.

Public Member Functions inherited from Cpl::Io::Input
virtual	~Input ()
	Lets the make the destructor virtual.

Public Member Functions inherited from Cpl::Io::Close
virtual	~Close ()
	Lets the make the destructor virtual.

Public Member Functions inherited from Cpl::Container::Item
bool	insert_ (void *newContainerPtr)
	Helper method to trap when inserting an item in multiple containers.

bool	isInContainer_ (const void *containerPtr) const noexcept
	Returns 'true' if the instance is in the specified container.

Public Member Functions inherited from Cpl::Io::IsEos
virtual	~IsEos ()
	Lets the make the destructor virtual.

Public Member Functions inherited from Cpl::Io::File::ObjectApi
virtual	~ObjectApi ()
	Virtual destructor.

Public Member Functions inherited from Cpl::Io::Output
virtual	~Output ()
	Lets the make the destructor virtual.

Protected Attributes
Cpl::Io::Stdio::InputOutput_	m_stream
	Handles all of the reads/writes.

Additional Inherited Members
Static Public Member Functions inherited from Cpl::Container::Item
static void	remove_ (Item *itemPtr) noexcept
	Helper method to do the proper 'clean-up' for the multiple-containers-error-trap when removing an item from a container.

Public Attributes inherited from Cpl::Container::Item
void *	m_nextPtr_
	The link field.

void *	m_inListPtr_
	Debug field.

Protected Member Functions inherited from Cpl::Container::Item
	Item ()
	Constructor.

	Item (const char *)
	Constructor used ONLY with the child class MapItem: -->special constructor to allow a Map to be statically allocated.

Constructor & Destructor Documentation

◆ InputOutput() [1/2]

Cpl::Io::File::InputOutput::InputOutput	(	const char *	fileName,
		bool	forceCreate = `true`,
		bool	forceEmptyFile = `false`,
		bool	readOnly = `false`
	)

Constructor -->Opens the file (note: readOnly takes precedence over the other flags)

◆ InputOutput() [2/2]

Cpl::Io::File::InputOutput::InputOutput ( Cpl::Io::Descriptor streamfd )

Constructor. 'streamfd' is a the file descriptor of a existing/opened file.

◆ ~InputOutput()

Cpl::Io::File::InputOutput::~InputOutput ( )

Destructor -->Will insure the file gets closed.

Member Function Documentation

◆ available()

bool Cpl::Io::File::InputOutput::available ( )

virtual

See Cpl::Io::Input.

Implements Cpl::Io::Input.

◆ close()

void Cpl::Io::File::InputOutput::close ( )

virtual

See Cpl::Io::Close.

Implements Cpl::Io::Close.

◆ currentPos()

bool Cpl::Io::File::InputOutput::currentPos ( unsigned long & curPosition )

virtual

See Cpl::Io::File::ObjectApi.

Implements Cpl::Io::File::ObjectApi.

◆ flush()

void Cpl::Io::File::InputOutput::flush ( )

virtual

See Cpl::Io::Output.

Implements Cpl::Io::Output.

◆ getStream()

Cpl::Io::InputOutput & Cpl::Io::File::InputOutput::getStream ( )

virtual

See Cpl::Io::File::InputOutputApi.

Implements Cpl::Io::File::InputOutputApi.

◆ isEof()

bool Cpl::Io::File::InputOutput::isEof ( )

virtual

See Cpl::Io::File::ObjectApi.

Implements Cpl::Io::File::ObjectApi.

◆ isEos()

bool Cpl::Io::File::InputOutput::isEos ( )

virtual

See Cpl::Io::IsEos (is equivalent to isEof())

Implements Cpl::Io::IsEos.

◆ isOpened()

bool Cpl::Io::File::InputOutput::isOpened ( )

This method returns true if the Input AND Output streams where successfully open and/or is still opened (i.e.

close() has not been called). Note: it is okay to call other methods in the class if the file is not open - i.e. nothing 'bad' will happen and the method will return 'failed' status (when appropriate).