System::IO::BufferedStream Class Reference

Adds a buffering layer on top of another stream. Objects of this class should only be allocated using System::MakeObject() function. Never create instance of this type on stack or using operator new, as it will result in runtime errors and/or assertion faults. Always wrap this class into System::SmartPtr pointer and use this pointer to pass it to functions as argument. More...

Inherits System::IO::Stream.

Public Member Functions

ASPOSECPP_SHARED_API BufferedStream (const SharedPtr< Stream > &stream)
 Constructs an BufferedStream object that wraps the specified stream and uses a 4096 bytes long buffer. More...
 
ASPOSECPP_SHARED_API BufferedStream (const SharedPtr< Stream > &stream, int bufferSize)
 Constructs an BufferedStream object that wraps the specified stream and uses a buffer of the specified size. More...
 
virtual ASPOSECPP_SHARED_API ~BufferedStream ()
 Destructor. More...
 
virtual ASPOSECPP_SHARED_API int ReadByte () override
 Reads a single byte from the underlying stream and returns a 32-bit integer value equivalent to the value of the read byte. More...
 
virtual ASPOSECPP_SHARED_API void WriteByte (uint8_t value) override
 Writes the specified unsigned 8-bit integer value to the underlying stream. More...
 
virtual ASPOSECPP_SHARED_API int32_t Read (const ArrayPtr< uint8_t > &buffer, int32_t offset, int32_t count) override
 Reads the specified number of bytes from the underlying stream and writes them to the specified byte array. More...
 
virtual ASPOSECPP_SHARED_API int32_t Read (const System::Details::ArrayView< uint8_t > &buffer, int32_t offset, int32_t count) override
 Reads the specified number of bytes from the underlying stream and writes them to the specified byte array. More...
 
virtual ASPOSECPP_SHARED_API void Write (const ArrayPtr< uint8_t > &buffer, int32_t offset, int32_t count) override
 Writes the specified subrange of bytes from the specified byte array to the underlying stream. More...
 
virtual ASPOSECPP_SHARED_API void Write (const System::Details::ArrayView< uint8_t > &buffer, int32_t offset, int32_t count) override
 Writes the specified subrange of bytes from the specified byte array to the underlying stream. More...
 
virtual ASPOSECPP_SHARED_API int64_t Seek (int64_t offset, SeekOrigin origin) override
 Sets the position of the stream represented by the current object. More...
 
virtual ASPOSECPP_SHARED_API void SetLength (int64_t value) override
 Sets the length of the stream represented by the current object. More...
 
virtual ASPOSECPP_SHARED_API void Flush () override
 Writes the content of the buffer to the underlying stream. More...
 
virtual ASPOSECPP_SHARED_API void set_Position (int64_t value) override
 Flushes the buffer to the underlying stream and then sets the stream's position. More...
 
virtual ASPOSECPP_SHARED_API int64_t get_Position () const override
 Returns the current position of the stream. More...
 
virtual ASPOSECPP_SHARED_API int64_t get_Length () const override
 Returns the length of the stream. More...
 
virtual ASPOSECPP_SHARED_API bool get_CanRead () const override
 Determines if the stream is readable. More...
 
virtual ASPOSECPP_SHARED_API bool get_CanSeek () const override
 Determines if the stream supports seeking. More...
 
virtual ASPOSECPP_SHARED_API bool get_CanWrite () const override
 Determines if the stream is writable. More...
 
- Public Member Functions inherited from System::IO::Stream
template<std::size_t N>
int32_t Read (const System::Details::StackArray< uint8_t, N > &buffer, int32_t offset, int32_t count)
 Reads the specified number of bytes from the stream and writes them to the specified byte array. More...
 
template<std::size_t N>
void Write (const System::Details::StackArray< uint8_t, N > &buffer, int32_t offset, int32_t count)
 Writes the specified subrange of bytes from the specified byte array to the stream. More...
 
virtual void Close ()
 Closes the stream. More...
 
ASPOSECPP_SHARED_API void Dispose () override
 Releases all resources used by the current object and closes the stream. More...
 
virtual ASPOSECPP_SHARED_API System::SharedPtr< System::IAsyncResultBeginRead (System::ArrayPtr< uint8_t > buffer, int offset, int count, System::AsyncCallback callback, System::SharedPtr< System::Object > state)
 Initiates an asynchronous read operation. More...
 
virtual ASPOSECPP_SHARED_API System::SharedPtr< System::IAsyncResultBeginWrite (System::ArrayPtr< uint8_t > buffer, int offset, int count, System::AsyncCallback callback, System::SharedPtr< System::Object > state)
 Initiates an asynchronous write operation. More...
 
virtual ASPOSECPP_SHARED_API int EndRead (System::SharedPtr< System::IAsyncResult > asyncResult)
 Waits until the specified asynchronous read operation completes. More...
 
virtual ASPOSECPP_SHARED_API void EndWrite (System::SharedPtr< System::IAsyncResult > asyncResult)
 Ends an asynchronous write operation. Waits until the specified asynchronous write operation completes. More...
 
ASPOSECPP_SHARED_API void CopyTo (const SharedPtr< Stream > &destination)
 Copies bytes to the specified stream. More...
 
ASPOSECPP_SHARED_API void CopyTo (const SharedPtr< Stream > &destination, int32_t buffer_size)
 Copies bytes to the specified stream, using the specified buffer size. More...
 
virtual ASPOSECPP_SHARED_API bool get_CanTimeout () const
 Gets a value that determines whether the current stream can time out. More...
 
virtual ASPOSECPP_SHARED_API void set_ReadTimeout (int timeout)
 Sets a value that determines whether the current stream can time out. More...
 
virtual ASPOSECPP_SHARED_API int get_ReadTimeout () const
 Gets a value, in milliseconds, that determines how long the stream will attempt to read before timing out. More...
 
virtual ASPOSECPP_SHARED_API void set_WriteTimeout (int timeout)
 Sets a value, in milliseconds, that determines how long the stream will attempt to read before timing out. More...
 
virtual ASPOSECPP_SHARED_API int get_WriteTimeout () const
 Gets a value, in milliseconds, that determines how long the stream will attempt to write before timing out. More...
 
- Public Member Functions inherited from System::Object
ASPOSECPP_SHARED_API Object ()
 Creates object. Initializes all internal data structures. More...
 
virtual ASPOSECPP_SHARED_API ~Object ()
 Destroys object. Frees all internal data structures. More...
 
ASPOSECPP_SHARED_API Object (Object const &x)
 Copy constructor. Doesn't copy anything, really, just initializes new object and enables copy constructing subclasses. More...
 
Objectoperator= (Object const &x)
 Assignment operator. Doesn't copy anything, really, just initializes new object and enables copy constructing subclasses. More...
 
ObjectSharedRefAdded ()
 Increments shared reference count. Shouldn't be called directly; instead, use smart pointers or ThisProtector. More...
 
int SharedRefRemovedSafe ()
 Decrements and returns shared reference count. Shouldn't be called directly; instead, use smart pointers or ThisProtector. More...
 
int RemovedSharedRefs (int count)
 Decreases shared reference count by specified value. More...
 
Detail::SmartPtrCounter * WeakRefAdded ()
 Increments weak reference count. Shouldn't be called directly; instead, use smart pointers or ThisProtector. More...
 
void WeakRefRemoved ()
 Decrements weak reference count. Shouldn't be called directly; instead, use smart pointers or ThisProtector. More...
 
Detail::SmartPtrCounter * GetCounter ()
 Gets reference counter data structure associated with the object. More...
 
int SharedCount () const
 Gets current value of shared reference counter. More...
 
ASPOSECPP_SHARED_API void Lock ()
 Implements C# lock() statement locking. Call directly or use LockContext sentry object. More...
 
ASPOSECPP_SHARED_API void Unlock ()
 Implements C# lock() statement unlocking. Call directly or use LockContext sentry object. More...
 
virtual ASPOSECPP_SHARED_API bool Equals (ptr obj)
 Compares objects using C# Object.Equals semantics. More...
 
virtual ASPOSECPP_SHARED_API int32_t GetHashCode () const
 Analog of C# Object.GetHashCode() method. Enables hashing of custom objects. More...
 
virtual ASPOSECPP_SHARED_API String ToString () const
 Analog of C# Object.ToString() method. Enables converting custom objects to string. More...
 
virtual ASPOSECPP_SHARED_API ptr MemberwiseClone () const
 Analog of C# Object.MemberwiseClone() method. Enables cloning custom types. More...
 
virtual ASPOSECPP_SHARED_API const TypeInfoGetType () const
 Gets actual type of object. Analog of C# System.Object.GetType() call. More...
 
virtual ASPOSECPP_SHARED_API bool Is (const TypeInfo &targetType) const
 Check if object represents an instance of type described by targetType. Analog of C# 'is' operator. More...
 
virtual ASPOSECPP_SHARED_API void SetTemplateWeakPtr (uint32_t argument)
 Set n'th template argument a weak pointer (rather than shared). Allows switching pointers in containers to weak mode. More...
 
virtual ASPOSECPP_SHARED_API bool FastCast (const Details::FastRttiBase &helper, void **out_ptr) const
 For internal purposes only. More...
 
template<>
bool Equals (float const &objA, float const &objB)
 Emulates C#-style floating point comparison where two NaNs are considered equal even though according to IEC 60559:1989 NaN is not equal to any value, including NaN. More...
 
template<>
bool Equals (double const &objA, double const &objB)
 Emulates C#-style floating point comparison where two NaNs are considered equal even though according to IEC 60559:1989 NaN is not equal to any value, including NaN. More...
 
template<>
bool ReferenceEquals (String const &str, std::nullptr_t)
 Specialization of Object::ReferenceEquals for case of string and nullptr. More...
 
template<>
bool ReferenceEquals (String const &str1, String const &str2)
 Specialization of Object::ReferenceEquals for case of strings. More...
 

Additional Inherited Members

- Public Types inherited from System::IO::Stream
typedef SharedPtr< StreamPtr
 An alias for a shared pointer to this class. More...
 
- Public Types inherited from System::Object
typedef SmartPtr< Objectptr
 Alias for smart pointer type. More...
 
- Static Public Member Functions inherited from System::Object
static bool ReferenceEquals (ptr const &objA, ptr const &objB)
 Compares objects by reference. More...
 
template<typename T >
static std::enable_if<!IsSmartPtr< T >::value, bool >::type ReferenceEquals (T const &objA, T const &objB)
 Compares objects by reference. More...
 
template<typename T >
static std::enable_if<!IsSmartPtr< T >::value, bool >::type ReferenceEquals (T const &objA, std::nullptr_t)
 Reference-compares value type object with nullptr. More...
 
template<typename T1 , typename T2 >
static std::enable_if< IsSmartPtr< T1 >::value &&IsSmartPtr< T2 >::value, bool >::type Equals (T1 const &objA, T2 const &objB)
 Compares reference type objects in C# style. More...
 
template<typename T1 , typename T2 >
static std::enable_if<!IsSmartPtr< T1 >::value &&!IsSmartPtr< T2 >::value, bool >::type Equals (T1 const &objA, T2 const &objB)
 Compares value type objects in C# style. More...
 
static const TypeInfoType ()
 Implements C# typeof(System.Object) construct. More...
 
- Static Public Attributes inherited from System::IO::Stream
static const System::SharedPtr< Stream > ASPOSECPP_SHARED_API Null
 A stream with no underlying storage. More...
 
- Protected Member Functions inherited from System::IO::Stream
virtual ASPOSECPP_SHARED_API void Dispose (bool disposing)
 Releases all resources used by the current object and closes the stream. More...
 

Detailed Description

Adds a buffering layer on top of another stream. Objects of this class should only be allocated using System::MakeObject() function. Never create instance of this type on stack or using operator new, as it will result in runtime errors and/or assertion faults. Always wrap this class into System::SmartPtr pointer and use this pointer to pass it to functions as argument.

Constructor & Destructor Documentation

◆ BufferedStream() [1/2]

ASPOSECPP_SHARED_API System::IO::BufferedStream::BufferedStream ( const SharedPtr< Stream > &  stream)

Constructs an BufferedStream object that wraps the specified stream and uses a 4096 bytes long buffer.

Parameters
streamThe underlying Stream object

◆ BufferedStream() [2/2]

ASPOSECPP_SHARED_API System::IO::BufferedStream::BufferedStream ( const SharedPtr< Stream > &  stream,
int  bufferSize 
)

Constructs an BufferedStream object that wraps the specified stream and uses a buffer of the specified size.

Parameters
streamThe underlying Stream object
bufferSizeThe size of the buffer in bytes

◆ ~BufferedStream()

virtual ASPOSECPP_SHARED_API System::IO::BufferedStream::~BufferedStream ( )
virtual

Destructor.

Member Function Documentation

◆ Flush()

virtual ASPOSECPP_SHARED_API void System::IO::BufferedStream::Flush ( )
overridevirtual

Writes the content of the buffer to the underlying stream.

Implements System::IO::Stream.

◆ get_CanRead()

virtual ASPOSECPP_SHARED_API bool System::IO::BufferedStream::get_CanRead ( ) const
overridevirtual

Determines if the stream is readable.

Returns
True if the stream is readable; otherwise - false

Implements System::IO::Stream.

◆ get_CanSeek()

virtual ASPOSECPP_SHARED_API bool System::IO::BufferedStream::get_CanSeek ( ) const
overridevirtual

Determines if the stream supports seeking.

Returns
True if the stream supports seeking; otherwise - false

Implements System::IO::Stream.

◆ get_CanWrite()

virtual ASPOSECPP_SHARED_API bool System::IO::BufferedStream::get_CanWrite ( ) const
overridevirtual

Determines if the stream is writable.

Returns
True if the stream is writable; otherwise - false

Implements System::IO::Stream.

◆ get_Length()

virtual ASPOSECPP_SHARED_API int64_t System::IO::BufferedStream::get_Length ( ) const
overridevirtual

Returns the length of the stream.

Implements System::IO::Stream.

◆ get_Position()

virtual ASPOSECPP_SHARED_API int64_t System::IO::BufferedStream::get_Position ( ) const
overridevirtual

Returns the current position of the stream.

Implements System::IO::Stream.

◆ Read() [1/2]

virtual ASPOSECPP_SHARED_API int32_t System::IO::BufferedStream::Read ( const ArrayPtr< uint8_t > &  buffer,
int32_t  offset,
int32_t  count 
)
overridevirtual

Reads the specified number of bytes from the underlying stream and writes them to the specified byte array.

Parameters
bufferThe byte array to write the read bytes to
offsetA 0-based position in buffer to start writing at
countThe number of bytes to read
Returns
The number of bytes read

Implements System::IO::Stream.

◆ Read() [2/2]

virtual ASPOSECPP_SHARED_API int32_t System::IO::BufferedStream::Read ( const System::Details::ArrayView< uint8_t > &  buffer,
int32_t  offset,
int32_t  count 
)
overridevirtual

Reads the specified number of bytes from the underlying stream and writes them to the specified byte array.

Parameters
bufferThe byte array to write the read bytes to
offsetA 0-based position in buffer to start writing at
countThe number of bytes to read
Returns
The number of bytes read

Reimplemented from System::IO::Stream.

◆ ReadByte()

virtual ASPOSECPP_SHARED_API int System::IO::BufferedStream::ReadByte ( )
overridevirtual

Reads a single byte from the underlying stream and returns a 32-bit integer value equivalent to the value of the read byte.

Reimplemented from System::IO::Stream.

◆ Seek()

virtual ASPOSECPP_SHARED_API int64_t System::IO::BufferedStream::Seek ( int64_t  offset,
SeekOrigin  origin 
)
overridevirtual

Sets the position of the stream represented by the current object.

Parameters
offsetThe byte offset relative to a position specified by origin
originSpecifies the position from which and the direction toward which the offset is calculated
Returns
The new position of the stream

Implements System::IO::Stream.

◆ set_Position()

virtual ASPOSECPP_SHARED_API void System::IO::BufferedStream::set_Position ( int64_t  value)
overridevirtual

Flushes the buffer to the underlying stream and then sets the stream's position.

Parameters
valueThe byte offset to set the stream's position to

Implements System::IO::Stream.

◆ SetLength()

virtual ASPOSECPP_SHARED_API void System::IO::BufferedStream::SetLength ( int64_t  value)
overridevirtual

Sets the length of the stream represented by the current object.

Parameters
valueThe length in bytes to set

Implements System::IO::Stream.

◆ Write() [1/2]

virtual ASPOSECPP_SHARED_API void System::IO::BufferedStream::Write ( const ArrayPtr< uint8_t > &  buffer,
int32_t  offset,
int32_t  count 
)
overridevirtual

Writes the specified subrange of bytes from the specified byte array to the underlying stream.

Parameters
bufferThe array containing the bytes to write
offsetA 0-based index of the ellemnet in buffer at which the subrange to write begins
countThe number of elements in the subrange to write

Implements System::IO::Stream.

◆ Write() [2/2]

virtual ASPOSECPP_SHARED_API void System::IO::BufferedStream::Write ( const System::Details::ArrayView< uint8_t > &  buffer,
int32_t  offset,
int32_t  count 
)
overridevirtual

Writes the specified subrange of bytes from the specified byte array to the underlying stream.

Parameters
bufferThe array containing the bytes to write
offsetA 0-based index of the ellemnet in buffer at which the subrange to write begins
countThe number of elements in the subrange to write

Reimplemented from System::IO::Stream.

◆ WriteByte()

virtual ASPOSECPP_SHARED_API void System::IO::BufferedStream::WriteByte ( uint8_t  value)
overridevirtual

Writes the specified unsigned 8-bit integer value to the underlying stream.

Parameters
valueThe value to write

Reimplemented from System::IO::Stream.