Exposes a Stream around a file, supporting read and write operations. More...

#include <FileStream.hpp>

Inheritance diagram for Arp::System::Commons::Io::FileStream:

Public Types
using	IFileService = Arp::System::Ve::IFileService

Public Member Functions
	FileStream (const String &path, FileMode mode)
	Initializes a new instance of the FileStream class. More...

	FileStream (const String &path, FileMode mode, FileAccess access)
	Initializes a new instance of the FileStream class. After close operation, the synchronization of the file system will be enforced for this file. More...

	FileStream (const String &path, FileMode mode, FileAccess access, bool sync)
	Initializes a new instance of the FileStream class. More...

	FileStream (const FileStream &arg)=delete
	Copy constructor.

FileStream &	operator= (const FileStream &arg)=delete
	Assignment operator.

	~FileStream (void) override
	Destructs this instance and frees all resources.

boolean	CanRead (void) override
	Checks if the stream is opened for read-access. More...

boolean	CanWrite (void) override
	Checks if the stream is opened for write-access. More...

boolean	CanSeek (void) override
	Checks if seek operations are possible. More...

size_t	GetLength (void) override
	Returns the size of the opened file in bytes. More...

void	SetLength (size_t length) override
	Reserves a specific amount of bytes for the opened file. More...

size_t	GetPosition (void) override
	Returns the byte offset of the internal stream pointer from the beginning of the file. More...

void	SetPosition (size_t position) override
	Sets a new position of the internal stream pointer. More...

void	Flush (void) override
	Forces a write of all possibly buffered data (input stream) or discards any buffered not yet read by the user (output stream). More...

size_t	Seek (size_t offset, SeekOrigin origin) override
	Sets a new position if the internal stream pointer relative to a specific position. More...

size_t	Read (byte *pBuffer, size_t bufferSize, size_t offset, size_t count) override
	Reads data from stream into assigned buffer at a specific offset. More...

void	Write (const byte *pBuffer, size_t bufferSize, size_t offset, size_t count) override
	Writes data from assigned buffer to stream. More...

Public Member Functions inherited from Arp::System::Commons::Io::Stream
	Stream (void)
	Constructs an Stream instance.

	Stream (const Stream &arg)=delete
	Copy constructor.

Stream &	operator= (const Stream &arg)=delete
	Assignment operator.

virtual	~Stream (void)
	Destructs this instance and frees all resources.

virtual boolean	CanRead (void)=0

virtual boolean	CanWrite (void)=0

virtual boolean	CanSeek (void)=0

virtual size_t	GetLength (void)=0

virtual void	SetLength (size_t length)=0

virtual size_t	GetPosition (void)=0

virtual void	SetPosition (size_t position)=0

virtual void	Flush (void)=0

virtual size_t	Seek (size_t offset, SeekOrigin origin)=0

virtual size_t	Read (byte *pBuffer, size_t bufferSize, size_t offset, size_t count)=0

virtual void	Write (const byte *pBuffer, size_t bufferSize, size_t offset, size_t count)=0

virtual byte	ReadByte (void)

virtual void	WriteByte (byte value)

virtual void	CopyTo (Stream &other)

void	Dispose (void)

void	Close (void)

Protected Member Functions
void	InternalDispose (void) override

Protected Member Functions inherited from Arp::System::Commons::Io::Stream
boolean	IsDisposed (void)

void	CheckDisposed (void)

virtual void	InternalDispose (void)=0

Additional Inherited Members
Static Public Attributes inherited from Arp::System::Commons::Io::Stream
static NullStream	Empty

Detailed Description

Exposes a Stream around a file, supporting read and write operations.

Constructor & Destructor Documentation

◆ FileStream() [1/3]

Arp::System::Commons::Io::FileStream::FileStream	(	const String &	path,
		FileMode	mode
	)

inline

Initializes a new instance of the FileStream class.

The file is opened or created with read-write permissions.

Parameters

path	The path of the file to open..
mode	The open mode.

Exceptions

Arp::System::Commons::ArgumentException	if path is an empty string.
Arp::System::Commons::Io::AlreadyExistsException	if #Arp::Syste::Commons::Io::FileMode::CreateNew is chosen and the file does already exists.
Arp::System::Commons::Io::NotExistException	if a file should be opened that does not exist.
Arp::System::Commons::Io::InvalidPathException	in case an error occured that is not already handled by the other exceptions.

◆ FileStream() [2/3]

Arp::System::Commons::Io::FileStream::FileStream	(	const String &	path,
		FileMode	mode,
		FileAccess	access
	)

inline

Initializes a new instance of the FileStream class. After close operation, the synchronization of the file system will be enforced for this file.

Parameters

path	The path of the file to open..
mode	The open mode.
access	The access mode.

Exceptions

Arp::System::Commons::ArgumentException	if path is an empty string.
Arp::System::Commons::Io::AlreadyExistsException	if #Arp::Syste::Commons::Io::FileMode::CreateNew is chosen and the file does already exists.
Arp::System::Commons::Io::NotExistException	if a file should be opened that does not exist.
Arp::System::Commons::Io::InvalidPathException	in case an error occured that is not already handled by the other exceptions.

◆ FileStream() [3/3]

Arp::System::Commons::Io::FileStream::FileStream	(	const String &	path,
		FileMode	mode,
		FileAccess	access,
		bool	sync
	)

inline

Initializes a new instance of the FileStream class.

Parameters

path	The path of the file to open..
mode	The open mode.
access	The access mode.
sync	If set to `true`, the synchronization of the file system is enforced after close operation for this file.

Exceptions

Arp::System::Commons::ArgumentException	if path is an empty string.
Arp::System::Commons::Io::AlreadyExistsException	if #Arp::Syste::Commons::Io::FileMode::CreateNew is chosen and the file does already exists.
Arp::System::Commons::Io::NotExistException	if a file should be opened that does not exist.
Arp::System::Commons::Io::InvalidPathException	in case an error occured that is not already handled by the other exceptions.

Member Function Documentation

◆ CanRead()

boolean Arp::System::Commons::Io::FileStream::CanRead ( void )

overridevirtual

Checks if the stream is opened for read-access.

Returns: True if stream is opened for read-access, otherwise false is returned.

Implements Arp::System::Commons::Io::Stream.

◆ CanSeek()

boolean Arp::System::Commons::Io::FileStream::CanSeek ( void )

overridevirtual

Checks if seek operations are possible.

Returns: True if seek operations are possible, otherwise false is returned.

Implements Arp::System::Commons::Io::Stream.

◆ CanWrite()

boolean Arp::System::Commons::Io::FileStream::CanWrite ( void )

overridevirtual

Checks if the stream is opened for write-access.

Returns: True if stream is opened for write-access, otherwise false is returned.

Implements Arp::System::Commons::Io::Stream.

◆ Flush()

void Arp::System::Commons::Io::FileStream::Flush ( void )

overridevirtual

Forces a write of all possibly buffered data (input stream) or discards any buffered not yet read by the user (output stream).

Exceptions

Arp::System::Commons::ObjectDisposedException if the stream was already disposed.

Implements Arp::System::Commons::Io::Stream.

◆ GetLength()

size_t Arp::System::Commons::Io::FileStream::GetLength ( void )

overridevirtual

Returns the size of the opened file in bytes.

Exceptions

Arp::System::Commons::ObjectDisposedException if the stream was already disposed.

Returns: Byte size of opened file.

Implements Arp::System::Commons::Io::Stream.

◆ GetPosition()

size_t Arp::System::Commons::Io::FileStream::GetPosition ( void )

overridevirtual

Returns the byte offset of the internal stream pointer from the beginning of the file.

The next read or write operation will be performed from this byte offset on.

Exceptions

Arp::System::Commons::ObjectDisposedException if the stream was already disposed.

Returns: Byte offset from file beginning of internal stream pointer.

Implements Arp::System::Commons::Io::Stream.

◆ InternalDispose()

void Arp::System::Commons::Io::FileStream::InternalDispose ( void )

overrideprotectedvirtual

Implements Arp::System::Commons::Io::Stream.

◆ Read()

size_t Arp::System::Commons::Io::FileStream::Read	(	byte *	pBuffer,
		size_t	bufferSize,
		size_t	offset,
		size_t	count
	)

overridevirtual

Reads data from stream into assigned buffer at a specific offset.

Parameters

pBuffer	Buffer where read data can be stored.
bufferSize	Maximal capacity of buffer pBuffer.
offset	Offset in pBuffer where read data should be stored.
count	Amount of bytes to read from stream.

Exceptions

Arp::System::Commons::ArgumentNullException	if `pBuffer` is nullptr.
Arp::System::Commons::ObjectDisposedException	if the stream was already disposed.
Arp::System::Commons::ArgumentOutOfRangeException	if `offset` plus `count` is greater than `bufferSize`.
Arp::System::Commons::NotSupportedException	if this stream is not readable.

Returns: The number of bytes read from stream and stored in assigned buffer.

Implements Arp::System::Commons::Io::Stream.

◆ Seek()

size_t Arp::System::Commons::Io::FileStream::Seek	(	size_t	offset,
		SeekOrigin	origin
	)

overridevirtual

Sets a new position if the internal stream pointer relative to a specific position.

Parameters

offset	Offset in byte from the reference position, can also be negativ.
origin	Reference from where the offset is added to calculate the new position of the file stream pointer.

Exceptions

Arp::System::Commons::ObjectDisposedException if the stream was already disposed.

Returns: The new offset in bytes from the beginning of the stream.

Implements Arp::System::Commons::Io::Stream.

◆ SetLength()

void Arp::System::Commons::Io::FileStream::SetLength ( size_t length )

overridevirtual

Reserves a specific amount of bytes for the opened file.

This method is not supported for FileStream class instances.

Exceptions

Arp::System::Commons::NotSupportedException

Parameters

length Desired byte-size of opened file.

Implements Arp::System::Commons::Io::Stream.

◆ SetPosition()

void Arp::System::Commons::Io::FileStream::SetPosition ( size_t position )

overridevirtual

Sets a new position of the internal stream pointer.

The assigned position value is interpreted as a byte offset from the beginning of the opened file.

Exceptions

Arp::System::Commons::ObjectDisposedException if the stream was already disposed.

Parameters

position Byte-offset for the internal stream pointer from the beginning of the file.

Implements Arp::System::Commons::Io::Stream.

◆ Write()

void Arp::System::Commons::Io::FileStream::Write	(	const byte *	pBuffer,
		size_t	bufferSize,
		size_t	offset,
		size_t	count
	)

overridevirtual

Writes data from assigned buffer to stream.

Parameters

pBuffer	Pointer to data-location.
bufferSize	Amount of bytes stored inpBuffer
offset	Byte offset from location pBuffer where storing of data starts.
count	Amount of bytes to be store via FileStream. Data from offset to offset + count will be stored.

Exceptions

Arp::System::Commons::ArgumentNullException	if `pBuffer` is nullptr.
Arp::System::Commons::ObjectDisposedException	if the stream was already disposed.
Arp::System::Commons::ArgumentOutOfRangeException	if `offset` plus `count` is greater than `bufferSize`.
Arp::System::Commons::NotSupportedException	if this stream is not writeable.

Returns: The number of bytes written to streamed file.

Implements Arp::System::Commons::Io::Stream.

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

Arp/System/Commons/Io/FileStream.hpp

Public Types

Public Member Functions

Protected Member Functions

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

◆ FileStream() [1/3]

◆ FileStream() [2/3]

◆ FileStream() [3/3]

Member Function Documentation

◆ CanRead()

◆ CanSeek()

◆ CanWrite()

◆ Flush()

◆ GetLength()

◆ GetPosition()

◆ InternalDispose()

◆ Read()

◆ Seek()

◆ SetLength()

◆ SetPosition()

◆ Write()