A composite buffer contains zero, one or more proton buffer instances chained together to behave as if it were one single contiguous buffer which can be read or written to. More...

Inheritance diagram for Apache.Qpid.Proton.Buffer.ProtonCompositeBuffer:

Public Member Functions
IProtonBuffer	Fill (byte value)
	Fill the buffer with the given byte value. This method does not respect the read offset nor the write offset but instead fills the entire backing buffer memory with the given value.

IProtonBuffer	Reset ()
	Resets the read and write offset values to zero.

IProtonBuffer	SkipBytes (long amount)
	Advance the buffer read offset by the specified amount effectively skipping that number of bytes from being read.

IProtonCompositeBuffer	Append (IProtonBuffer buffer)
	Appends the provided buffer to the end of the list of composite buffers already managed by this buffer. The given buffer becomes the property of the composite and the constraints placed upon buffers managed by the composite implementation are extended to this appended buffer.

IProtonBuffer	Compact ()
	Discards the read bytes, and moves the buffer contents to the beginning of the buffer.

IProtonBuffer	Reclaim ()
	Reclaims read buffer space and returns it to the operating system or other pooling mechanisms if those are in place, then compacts the remaining buffer contents. For a non-composite buffer this operation could consist of allocating a smaller buffer to house any remaining unread bytes and freeing the larger backing buffer in some cases or it may result in a no-op depending on the buffer implementation. For the composite buffer case this operation provides an API which allows for fully read buffer constituents to be released and returned to a memory pool or back to the O/S.

IProtonBuffer	WriteSplit (long offset)
	Splits the buffer into two distinct buffers at the given index plus the current write offset. The returned buffer will retain the read offset and write offset of this buffer but will be truncated to match the capacity provided by the split index, which implies that they might both be set to the capacity if they were previously set to the split index. The returned buffer will set its read and write offsets to zero if they fell prior to the given index otherwise they will be truncated to match the new buffer capacity. Split buffers support the standard buffer operations including resizing to ensure writable regions which implies that a buffer resize on either will cause them to no longer reference the same underlying memory region. If buffer implementations implement pooling then they must ensure proper release of shared buffer regions once both buffers no longer reference them.

IProtonBuffer	ReadSplit (long offset)
	Splits the buffer into two distinct buffers at the given index plus the current read offset. The returned buffer will retain the read offset and write offset of this buffer but will be truncated to match the capacity provided by the split index, which implies that they might both be set to the capacity if they were previously set beyond the split index. The returned buffer will set its read and write offsets to zero if they fell prior to the given index otherwise they will be truncated to match the new buffer capacity. Split buffers support the standard buffer operations including resizing to ensure writable regions which implies that a buffer resize on either will cause them to no longer reference the same underlying memory region. If buffer implementations implement pooling then they must ensure proper release of shared buffer regions once both buffers no longer reference them.

IProtonBuffer	Split ()
	Splits the buffer into two buffers at the write offset. The resulting buffer will comprise the read and readable portions of this buffer with the write offset and capacity set to the current write offset. This buffer will lose access to the split region and its read offset will be set to the current write offset. This buffer will also have its capacity reduced by the number of bytes in the returned buffer (i.e. the current number of read and readable bytes). Split buffers support the standard buffer operations including resizing to ensure writable regions which implies that a buffer resize on either will cause them to no longer reference the same underlying memory region. If buffer implementations implement pooling then they must ensure proper release of shared buffer regions once both buffers no longer reference them.

IProtonBuffer	Split (long offset)
	Splits the buffer into two distinct buffers at the given index. The returned buffer will retain the read offset and write offset of this buffer but will be truncated to match the capacity provided by the split index, which implies that they might both be set to the capacity if they were previously set beyond the split index. The returned buffer will set its read and write offsets to zero if they fell prior to the given index otherwise they will be truncated to match the new buffer capacity. Split buffers support the standard buffer operations including resizing to ensure writable regions which implies that a buffer resize on either will cause them to no longer reference the same underlying memory region. If buffer implementations implement pooling then they must ensure proper release of shared buffer regions once both buffers no longer reference them.

IEnumerable< IProtonBuffer >	DecomposeBuffer ()
	Serves as a means of breaking up a composite buffer into an enumeration of the constituent buffers that is manages. Decomposing a buffer serves to consume the buffer leaving it an empty state, and the returned buffers are considered the property of the caller.

IProtonBuffer	Copy ()
	Returns a copy of this buffer's readable bytes. Modifying the content of the returned buffer will not affect this buffers contents. The two buffers will maintain separate offsets. The returned copy has the write offset set to the length of the copy meaning that the entire copied region is read for reading.

IProtonBuffer	Copy (long index, long length)
	Returns a copy of this buffer's readable bytes. Modifying the content of the returned buffer will not affect this buffers contents. The two buffers will maintain separate offsets. The amount and start of the data to be copied is provided by the index and length arguments. The returned copy has the write offset set to the length of the copy meaning that the entire copied region is read for reading.

IProtonBuffer	CopyInto (long srcPos, byte[] dest, long destPos, long length)
	Copies the given number of bytes from this buffer into the target byte buffer starting the read from the given position in this buffer and the write to at the given position in the destination buffer. The length parameter controls how many bytes are copied to the destination. This method does not modify the read or write offset values in this buffer.

IProtonBuffer	CopyInto (long srcPos, IProtonBuffer dest, long destPos, long length)
	Copies the given number of bytes from this buffer into the target byte buffer starting the read from the given position in this buffer and the write to at the given position in the destination buffer. The length parameter controls how many bytes are copied to the destination. This method does not modify the read or write offset values in this buffer nor those of the destination buffer. The destination write index is an absolute index value unrelated to the write offset of the target.

IProtonBuffer	EnsureWritable (long amount)
	Requests that the buffer ensure that there is enough allocated internal capacity such that the given number of bytes can be written without requiring additional allocations and that this amount does not exceed any total capacity restrictions for this buffer.

int	CompareTo (object obj)

int	CompareTo (IProtonBuffer other)

bool	Equals (IProtonBuffer other)

override int	GetHashCode ()

int	ForEachReadableComponent (in int index, in Func< int, IReadableComponent, bool > processor)
	Invokes the provided delegate for each readable component in this buffer and increments the provided index value for each invocation. The total number of buffers processed is returned to the caller. The delegate can stop processing at any time by returning false in which case this method will stop and return a negative value to indicate that processing stopped early and did not traverse all available components.

int	ForEachWritableComponent (in int index, in Func< int, IWritableComponent, bool > processor)
	Invokes the provided delegate for each writable component in this buffer and increments the provided index value for each invocation. The total number of buffers processed is returned to the caller. The delegate can stop processing at any time by returning false in which case this method will stop and return a negative value to indicate that processing stopped early and did not traverse all available components.

bool	GetBoolean (long index)
	Reads a single byte from the given index and returns a boolean value indicating if the byte was zero (false) or greater than zero (true).

sbyte	GetByte (long index)
	Reads a single signed byte from the given index and returns it.

char	GetChar (long index)
	Reads a single 2 byte char from the given index and returns it.

double	GetDouble (long index)
	Reads a single 8 byte double from the given index and returns it.

float	GetFloat (long index)
	Reads a single 4 byte float from the given index and returns it.

short	GetShort (long index)
	Reads a single 2 byte short from the given index and returns it.

int	GetInt (long index)
	Reads a single 4 byte int from the given index and returns it.

long	GetLong (long index)
	Reads a single 8 byte long from the given index and returns it.

byte	GetUnsignedByte (long index)
	Reads a single unsigned byte from the given index and returns it.

ushort	GetUnsignedShort (long index)
	Reads a single 2 byte unsigned short from the given index and returns it.

uint	GetUnsignedInt (long index)
	Reads a single 4 byte unsigned int from the given index and returns it.

ulong	GetUnsignedLong (long index)
	Reads a single 8 byte unsigned long from the given index and returns it.

bool	ReadBoolean ()
	Reads the next byte from the buffer and returns the boolean value.

sbyte	ReadByte ()
	Read a signed byte from the buffer and advance the read offset.

char	ReadChar ()
	Reads the two bytes from the buffer and returns the char value.

double	ReadDouble ()
	Reads the next eight bytes from the buffer and returns the double value.

float	ReadFloat ()
	Reads the next four bytes from the buffer and returns the float value.

short	ReadShort ()
	Reads the next two bytes from the buffer and returns the short value.

int	ReadInt ()
	Reads the next four bytes from the buffer and returns the int value.

long	ReadLong ()
	Reads the next eight bytes from the buffer and returns the long value.

byte	ReadUnsignedByte ()
	Read a unsigned byte from the buffer and advance the read offset.

ushort	ReadUnsignedShort ()
	Reads the next two bytes from the buffer and returns the unsigned short value.

uint	ReadUnsignedInt ()
	Reads the next four bytes from the buffer and returns the unsigned int value.

ulong	ReadUnsignedLong ()
	Reads the next eight bytes from the buffer and returns the unsigned long value.

IProtonBuffer	SetBoolean (long index, bool value)
	Write the given boolean value at the given location in the buffer backing store without modifying the write offset of this buffer.

IProtonBuffer	SetByte (long index, sbyte value)
	Write the given byte value at the given location in the buffer backing store without modifying the write offset of this buffer.

IProtonBuffer	SetChar (long index, char value)
	Write the given 2 byte char value at the given location in the buffer backing store without modifying the write offset of this buffer.

IProtonBuffer	SetDouble (long index, double value)
	Write the given 8 byte double value at the given location in the buffer backing store without modifying the write offset of this buffer.

IProtonBuffer	SetFloat (long index, float value)
	Write the given 4 byte float value at the given location in the buffer backing store without modifying the write offset of this buffer.

IProtonBuffer	SetShort (long index, short value)
	Write the given 2 byte short value at the given location in the buffer backing store without modifying the write offset of this buffer.

IProtonBuffer	SetInt (long index, int value)
	Write the given 4 byte int value at the given location in the buffer backing store without modifying the write offset of this buffer.

IProtonBuffer	SetLong (long index, long value)
	Write the given 8 byte long value at the given location in the buffer backing store without modifying the write offset of this buffer.

IProtonBuffer	SetUnsignedByte (long index, byte value)
	Write the given unsigned byte value at the given location in the buffer backing store without modifying the write offset of this buffer.

IProtonBuffer	SetUnsignedShort (long index, ushort value)
	Write the given 2 byte unsigned short value at the given location in the buffer backing store without modifying the write offset of this buffer.

IProtonBuffer	SetUnsignedInt (long index, uint value)
	Write the given 4 byte unsigned int value at the given location in the buffer backing store without modifying the write offset of this buffer.

IProtonBuffer	SetUnsignedLong (long index, ulong value)
	Write the given 8 byte unsigned long value at the given location in the buffer backing store without modifying the write offset of this buffer.

IProtonBuffer	WriteBoolean (bool value)
	Writes the given boolean value into this buffer as a single byte and increases the write offset.

IProtonBuffer	WriteByte (sbyte value)
	Writes the given byte value into this buffer and increases the write offset.

IProtonBuffer	WriteDouble (double value)
	Writes the given eight byte double value into this buffer and increases the write offset.

IProtonBuffer	WriteFloat (float value)
	Writes the given four byte float value into this buffer and increases the write offset.

IProtonBuffer	WriteShort (short value)
	Writes the given two byte short value into this buffer and increases the write offset.

IProtonBuffer	WriteInt (int value)
	Writes the given four byte int value into this buffer and increases the write offset.

IProtonBuffer	WriteLong (long value)
	Writes the given eight byte long value into this buffer and increases the write offset.

IProtonBuffer	WriteUnsignedByte (byte value)
	Writes the given unsigned byte value into this buffer and increases the write offset.

IProtonBuffer	WriteUnsignedShort (ushort value)
	Writes the given two byte unsigned short value into this buffer and increases the write offset.

IProtonBuffer	WriteUnsignedInt (uint value)
	Writes the given four byte unsigned int value into this buffer and increases the write offset.

IProtonBuffer	WriteUnsignedLong (ulong value)
	Writes the given eight byte unsigned long value into this buffer and increases the write offset.

IProtonBuffer	WriteBytes (byte[] source)
	Writes the contents of the given byte array into this buffer and advances the write offset by the number of bytes written.

IProtonBuffer	WriteBytes (byte[] source, long offset, long length)
	Writes the contents of the given byte array into this buffer and advances the write offset by the number of bytes written.

IProtonBuffer	WriteBytes (IProtonBuffer source)
	Transfers the bytes from the source buffer to this buffer starting at the current write offset and continues until the source buffer becomes unreadable. The write index of this buffer is increased by the number of bytes read from the source. The method also increases the read offset of the source by the same amount as was written.

string	ToString (Encoding encoding)
	Coverts the readable bytes in this buffer into a string value using the Encoding value provided. The underlying read and write offset values are not modified as a result of this operation.

override string	ToString ()

Properties
long	Capacity `[get]`
	Gets the current capacity of this buffer instance which is the total amount of bytes that could be written before additional buffer capacity would be needed to allow more buffer writes. The remaining amount of writable bytes at any given time is the buffer capacity minus the write offset.

bool	IsReadable `[get]`
	Returns true if the current read offset is less than the current write offset meaning there are bytes available for reading.

long	ReadableBytes `[get]`
	Returns the number of bytes that can currently be read from this buffer.

bool	IsWritable `[get]`
	Returns true if write offset is less than the current buffer capacity limit.

long	WritableBytes `[get]`
	Returns the number of bytes that can currently be written from this buffer.

long	ReadOffset `[get, set]`
	Gets or sets the current read offset in this buffer. If the read offset is set to a value larger than the current write offset an exception is thrown.

long	WriteOffset `[get, set]`
	Gets or sets the current write offset in this buffer. If the write offset is set to a value less than the current read offset or larger than the current buffer capacity an exception is thrown.

uint	ComponentCount `[get]`
	Returns the number of component buffers in this buffer. If this is not a composite buffer instance then the count will always be one. For a composite buffer this will be the count of the current number of component buffers contained within.

uint	ReadableComponentCount `[get]`
	Returns the number of component buffers in this buffer that are readable and would be provided to calls to the for each readable buffer API. If this is not a composite buffer instance then the count will be at most one. For a composite buffer this will be the count of the current number of component buffers contained within that are readable.

uint	WritableComponentCount `[get]`
	Returns the number of component buffers in this buffer that are writable and would be provided to calls to the for each writable buffer API. If this is not a composite buffer instance then the count will be at most one. For a composite buffer this will be the count of the current number of component buffers contained within that are writable.

Properties inherited from Apache.Qpid.Proton.Buffer.IProtonBuffer
Properties inherited from Apache.Qpid.Proton.Buffer.IProtonBufferAccessors
byte	this[long i] `[get, set]`
	Indexed access to single unsigned byte values within the buffer which does not modify the read or write index value. The given index must adhere to the same constraints as the get byte and set byte level APIs in this buffer class.

Additional Inherited Members
Static Public Member Functions inherited from Apache.Qpid.Proton.Buffer.IProtonCompositeBuffer
static IProtonCompositeBuffer	Compose ()
	Creates a new empty composite buffer instance that can be extended with additional buffers or used directly to write initial data at which point the provided allocator will be used to create a buffer instance. At any point should the composite buffer need to allocate a new buffer in order to accommodate buffer writes a default buffer allocator will be used.

static IProtonCompositeBuffer	Compose (long maxCapacity)
	Creates a new empty composite buffer instance that can be extended with additional buffers or used directly to write initial data at which point the provided allocator will be used to create a buffer instance. At any point should the composite buffer need to allocate a new buffer in order to accommodate buffer writes a default buffer allocator will be used.

static IProtonCompositeBuffer	Compose (IProtonBufferAllocator allocator)
	Creates a new empty composite buffer instance that can be extended with additional buffers or used directly to write initial data at which point the provided allocator will be used to create a buffer instance. At any point should the composite buffer need to allocate a new buffer in order to accommodate buffer writes the provided allocator will be used.

static IProtonCompositeBuffer	Compose (IProtonBufferAllocator allocator, IEnumerable< IProtonBuffer > buffers)
	Creates a new composite buffer that is composed of the given enumeration of buffers.

static IProtonCompositeBuffer	Compose (IProtonBufferAllocator allocator, params IProtonBuffer[] buffers)
	Creates a new composite buffer that is composed of the given enumeration of buffers.

static IProtonCompositeBuffer	Compose (params IProtonBuffer[] buffers)
	Creates a new composite buffer that is composed of the given enumeration of buffers.

static IProtonCompositeBuffer	Compose (IEnumerable< IProtonBuffer > buffers)
	Creates a new composite buffer that is composed of the given enumeration of buffers.

static bool	IsComposite (IProtonBuffer buffer)
	Simpler helper API for user to check if a given buffer is indeed a composite buffer instance.

Detailed Description

A composite buffer contains zero, one or more proton buffer instances chained together to behave as if it were one single contiguous buffer which can be read or written to.

Member Function Documentation

◆ Append()

IProtonCompositeBuffer Apache.Qpid.Proton.Buffer.ProtonCompositeBuffer.Append ( IProtonBuffer extension )

inline

Appends the provided buffer to the end of the list of composite buffers already managed by this buffer. The given buffer becomes the property of the composite and the constraints placed upon buffers managed by the composite implementation are extended to this appended buffer.

Parameters

extension The buffer to append to the end of the composite set

Returns: This composite buffer instance.

Implements Apache.Qpid.Proton.Buffer.IProtonCompositeBuffer.

◆ Compact()

IProtonBuffer Apache.Qpid.Proton.Buffer.ProtonCompositeBuffer.Compact ( )

inline

Discards the read bytes, and moves the buffer contents to the beginning of the buffer.

Returns: this buffer instance

Implements Apache.Qpid.Proton.Buffer.IProtonBuffer.

◆ Copy() [1/2]

IProtonBuffer Apache.Qpid.Proton.Buffer.ProtonCompositeBuffer.Copy ( )

inline

Returns a copy of this buffer's readable bytes. Modifying the content of the returned buffer will not affect this buffers contents. The two buffers will maintain separate offsets. The returned copy has the write offset set to the length of the copy meaning that the entire copied region is read for reading.

Returns: A new buffer with a copy of the readable bytes in this buffer

Implements Apache.Qpid.Proton.Buffer.IProtonBuffer.

◆ Copy() [2/2]

IProtonBuffer Apache.Qpid.Proton.Buffer.ProtonCompositeBuffer.Copy	(	long	index,
		long	length
	)

inline

Returns a copy of this buffer's readable bytes. Modifying the content of the returned buffer will not affect this buffers contents. The two buffers will maintain separate offsets. The amount and start of the data to be copied is provided by the index and length arguments. The returned copy has the write offset set to the length of the copy meaning that the entire copied region is read for reading.

Parameters

index	The read offset where the copy begins
length	The number of bytes to copy

Returns: A new buffer with a copy of the readable bytes in the specified region

Implements Apache.Qpid.Proton.Buffer.IProtonBuffer.

◆ CopyInto() [1/2]

IProtonBuffer Apache.Qpid.Proton.Buffer.ProtonCompositeBuffer.CopyInto	(	long	srcPos,
		byte[]	dest,
		long	destPos,
		long	length
	)

inline

Copies the given number of bytes from this buffer into the target byte buffer starting the read from the given position in this buffer and the write to at the given position in the destination buffer. The length parameter controls how many bytes are copied to the destination. This method does not modify the read or write offset values in this buffer.

Parameters

srcPos	Position in this buffer to begin the copy from
dest	Destination buffer where the copied bytes are written
destPos	Position in the destination where the write begins
length	Number of byte to copy to the destination

Returns: This buffer instance.

Exceptions

IndexOutOfRangeException
ArgumentOutOfRangeException
ArgumentNullException

Implements Apache.Qpid.Proton.Buffer.IProtonBuffer.

◆ CopyInto() [2/2]

IProtonBuffer Apache.Qpid.Proton.Buffer.ProtonCompositeBuffer.CopyInto	(	long	srcPos,
		IProtonBuffer	dest,
		long	destPos,
		long	length
	)

inline

Copies the given number of bytes from this buffer into the target byte buffer starting the read from the given position in this buffer and the write to at the given position in the destination buffer. The length parameter controls how many bytes are copied to the destination. This method does not modify the read or write offset values in this buffer nor those of the destination buffer. The destination write index is an absolute index value unrelated to the write offset of the target.

Parameters

srcPos	Position in this buffer to begin the copy from
dest	Destination buffer where the copied bytes are written
destPos	Position in the destination where the write begins
length	Number of byte to copy to the destination

Returns: This buffer instance.

Exceptions

IndexOutOfRangeException
ArgumentOutOfRangeException
ArgumentNullException

Implements Apache.Qpid.Proton.Buffer.IProtonBuffer.

◆ DecomposeBuffer()

IEnumerable< IProtonBuffer > Apache.Qpid.Proton.Buffer.ProtonCompositeBuffer.DecomposeBuffer ( )

inline

Serves as a means of breaking up a composite buffer into an enumeration of the constituent buffers that is manages. Decomposing a buffer serves to consume the buffer leaving it an empty state, and the returned buffers are considered the property of the caller.

Returns

Implements Apache.Qpid.Proton.Buffer.IProtonCompositeBuffer.

◆ EnsureWritable()

IProtonBuffer Apache.Qpid.Proton.Buffer.ProtonCompositeBuffer.EnsureWritable ( long amount )

inline

Requests that the buffer ensure that there is enough allocated internal capacity such that the given number of bytes can be written without requiring additional allocations and that this amount does not exceed any total capacity restrictions for this buffer.

Parameters

amount the number of bytes that should be available fro writing

Returns: This buffer instance.

Exceptions

ArgumentOutOfRangeException If the requested amount exceeds capacity restrictions

Implements Apache.Qpid.Proton.Buffer.IProtonBuffer.

◆ Fill()

IProtonBuffer Apache.Qpid.Proton.Buffer.ProtonCompositeBuffer.Fill ( byte value )

inline

Fill the buffer with the given byte value. This method does not respect the read offset nor the write offset but instead fills the entire backing buffer memory with the given value.

Parameters

value The byte value to assign each byte in the backing store

Returns: This buffer instance.

Implements Apache.Qpid.Proton.Buffer.IProtonBuffer.

◆ ForEachReadableComponent()

int Apache.Qpid.Proton.Buffer.ProtonCompositeBuffer.ForEachReadableComponent	(	in int	index,
		in Func< int, IReadableComponent, bool >	processor
	)

inline

Invokes the provided delegate for each readable component in this buffer and increments the provided index value for each invocation. The total number of buffers processed is returned to the caller. The delegate can stop processing at any time by returning false in which case this method will stop and return a negative value to indicate that processing stopped early and did not traverse all available components.

Parameters

index	a starting index which is increment after each call
processor	The delegate that will receive the components

Returns: The number of components processed or negative if stopped early.

Implements Apache.Qpid.Proton.Buffer.IProtonBuffer.

◆ ForEachWritableComponent()

int Apache.Qpid.Proton.Buffer.ProtonCompositeBuffer.ForEachWritableComponent	(	in int	index,
		in Func< int, IWritableComponent, bool >	processor
	)

inline

Invokes the provided delegate for each writable component in this buffer and increments the provided index value for each invocation. The total number of buffers processed is returned to the caller. The delegate can stop processing at any time by returning false in which case this method will stop and return a negative value to indicate that processing stopped early and did not traverse all available components.

Parameters

index	a starting index which is increment after each call
processor	The delegate that will receive the components

Returns: The number of components processed or negative if stopped early.

Implements Apache.Qpid.Proton.Buffer.IProtonBuffer.

◆ GetBoolean()

bool Apache.Qpid.Proton.Buffer.ProtonCompositeBuffer.GetBoolean ( long index )

inline

Reads a single byte from the given index and returns a boolean value indicating if the byte was zero (false) or greater than zero (true).

Parameters

index

Returns: the boolean value of the byte at the given index

Exceptions

IndexOutOfRangeException If the index is negative or larger than buffer capacity

Implements Apache.Qpid.Proton.Buffer.IProtonBufferAccessors.

◆ GetByte()

sbyte Apache.Qpid.Proton.Buffer.ProtonCompositeBuffer.GetByte ( long index )

inline

Reads a single signed byte from the given index and returns it.

Parameters

index

Returns: the byte value at the given index

Exceptions

IndexOutOfRangeException If the index is negative or larger than buffer capacity

Implements Apache.Qpid.Proton.Buffer.IProtonBufferAccessors.

◆ GetChar()

char Apache.Qpid.Proton.Buffer.ProtonCompositeBuffer.GetChar ( long index )

inline

Reads a single 2 byte char from the given index and returns it.

Parameters

index

Returns: the char value at the given index

Exceptions

IndexOutOfRangeException If the index is negative or larger than buffer capacity

Implements Apache.Qpid.Proton.Buffer.IProtonBufferAccessors.

◆ GetDouble()

double Apache.Qpid.Proton.Buffer.ProtonCompositeBuffer.GetDouble ( long index )

inline

Reads a single 8 byte double from the given index and returns it.

Parameters

index

Returns: the double value at the given index

Exceptions

IndexOutOfRangeException If the index is negative or larger than buffer capacity

Implements Apache.Qpid.Proton.Buffer.IProtonBufferAccessors.

◆ GetFloat()

float Apache.Qpid.Proton.Buffer.ProtonCompositeBuffer.GetFloat ( long index )

inline

Reads a single 4 byte float from the given index and returns it.

Parameters

index

Returns: the float value at the given index

Exceptions

IndexOutOfRangeException If the index is negative or larger than buffer capacity

Implements Apache.Qpid.Proton.Buffer.IProtonBufferAccessors.

◆ GetInt()

int Apache.Qpid.Proton.Buffer.ProtonCompositeBuffer.GetInt ( long index )

inline

Reads a single 4 byte int from the given index and returns it.

Parameters

index

Returns: the int value at the given index

Exceptions

IndexOutOfRangeException If the index is negative or larger than buffer capacity

Implements Apache.Qpid.Proton.Buffer.IProtonBufferAccessors.

◆ GetLong()

long Apache.Qpid.Proton.Buffer.ProtonCompositeBuffer.GetLong ( long index )

inline

Reads a single 8 byte long from the given index and returns it.

Parameters

index

Returns: the long value at the given index

Exceptions

IndexOutOfRangeException If the index is negative or larger than buffer capacity

Implements Apache.Qpid.Proton.Buffer.IProtonBufferAccessors.

◆ GetShort()

short Apache.Qpid.Proton.Buffer.ProtonCompositeBuffer.GetShort ( long index )

inline

Reads a single 2 byte short from the given index and returns it.

Parameters

index

Returns: the short value at the given index

Exceptions

IndexOutOfRangeException If the index is negative or larger than buffer capacity

Implements Apache.Qpid.Proton.Buffer.IProtonBufferAccessors.

◆ GetUnsignedByte()

byte Apache.Qpid.Proton.Buffer.ProtonCompositeBuffer.GetUnsignedByte ( long index )

inline

Reads a single unsigned byte from the given index and returns it.

Parameters

index

Returns: the byte value at the given index

Exceptions

IndexOutOfRangeException If the index is negative or larger than buffer capacity

Implements Apache.Qpid.Proton.Buffer.IProtonBufferAccessors.

◆ GetUnsignedInt()

uint Apache.Qpid.Proton.Buffer.ProtonCompositeBuffer.GetUnsignedInt ( long index )

inline

Reads a single 4 byte unsigned int from the given index and returns it.

Parameters

index

Returns: the int value at the given index

Exceptions

IndexOutOfRangeException If the index is negative or larger than buffer capacity

Implements Apache.Qpid.Proton.Buffer.IProtonBufferAccessors.

◆ GetUnsignedLong()

ulong Apache.Qpid.Proton.Buffer.ProtonCompositeBuffer.GetUnsignedLong ( long index )

inline

Reads a single 8 byte unsigned long from the given index and returns it.

Parameters

index

Returns: the long value at the given index

Exceptions

IndexOutOfRangeException If the index is negative or larger than buffer capacity

Implements Apache.Qpid.Proton.Buffer.IProtonBufferAccessors.

◆ GetUnsignedShort()

ushort Apache.Qpid.Proton.Buffer.ProtonCompositeBuffer.GetUnsignedShort ( long index )

inline

Reads a single 2 byte unsigned short from the given index and returns it.

Parameters

index

Returns: the short value at the given index

Exceptions

IndexOutOfRangeException If the index is negative or larger than buffer capacity

Implements Apache.Qpid.Proton.Buffer.IProtonBufferAccessors.

◆ ReadBoolean()

bool Apache.Qpid.Proton.Buffer.ProtonCompositeBuffer.ReadBoolean ( )

inline

Reads the next byte from the buffer and returns the boolean value.

Returns: the boolean value at the given index

Exceptions

IndexOutOfRangeException If there are not enough readable bytes

Implements Apache.Qpid.Proton.Buffer.IProtonBufferAccessors.

◆ ReadByte()

sbyte Apache.Qpid.Proton.Buffer.ProtonCompositeBuffer.ReadByte ( )

inline

Read a signed byte from the buffer and advance the read offset.

Returns: The value read from the buffer

Exceptions

IndexOutOfRangeException If the buffer has no more readable bytes

Implements Apache.Qpid.Proton.Buffer.IProtonBufferAccessors.

◆ ReadChar()

char Apache.Qpid.Proton.Buffer.ProtonCompositeBuffer.ReadChar ( )

inline

Reads the two bytes from the buffer and returns the char value.

Returns: the char value at the given index

Exceptions

IndexOutOfRangeException If there are not enough readable bytes

Implements Apache.Qpid.Proton.Buffer.IProtonBufferAccessors.

◆ ReadDouble()

double Apache.Qpid.Proton.Buffer.ProtonCompositeBuffer.ReadDouble ( )

inline

Reads the next eight bytes from the buffer and returns the double value.

Returns: the double value at the given index

Exceptions

IndexOutOfRangeException If there are not enough readable bytes

Implements Apache.Qpid.Proton.Buffer.IProtonBufferAccessors.

◆ ReadFloat()

float Apache.Qpid.Proton.Buffer.ProtonCompositeBuffer.ReadFloat ( )

inline

Reads the next four bytes from the buffer and returns the float value.

Returns: the float value at the given index

Exceptions

IndexOutOfRangeException If there are not enough readable bytes

Implements Apache.Qpid.Proton.Buffer.IProtonBufferAccessors.

◆ ReadInt()

int Apache.Qpid.Proton.Buffer.ProtonCompositeBuffer.ReadInt ( )

inline

Reads the next four bytes from the buffer and returns the int value.

Returns: the int value at the given index

Exceptions

IndexOutOfRangeException If there are not enough readable bytes

Implements Apache.Qpid.Proton.Buffer.IProtonBufferAccessors.

◆ ReadLong()

long Apache.Qpid.Proton.Buffer.ProtonCompositeBuffer.ReadLong ( )

inline

Reads the next eight bytes from the buffer and returns the long value.

Returns: the long value at the given index

Exceptions

IndexOutOfRangeException If there are not enough readable bytes

Implements Apache.Qpid.Proton.Buffer.IProtonBufferAccessors.

◆ ReadShort()

short Apache.Qpid.Proton.Buffer.ProtonCompositeBuffer.ReadShort ( )

inline

Reads the next two bytes from the buffer and returns the short value.

Returns: the short value at the given index

Exceptions

IndexOutOfRangeException If there are not enough readable bytes

Implements Apache.Qpid.Proton.Buffer.IProtonBufferAccessors.

◆ ReadSplit()

IProtonBuffer Apache.Qpid.Proton.Buffer.ProtonCompositeBuffer.ReadSplit ( long offset )

inline

Splits the buffer into two distinct buffers at the given index plus the current read offset. The returned buffer will retain the read offset and write offset of this buffer but will be truncated to match the capacity provided by the split index, which implies that they might both be set to the capacity if they were previously set beyond the split index. The returned buffer will set its read and write offsets to zero if they fell prior to the given index otherwise they will be truncated to match the new buffer capacity. Split buffers support the standard buffer operations including resizing to ensure writable regions which implies that a buffer resize on either will cause them to no longer reference the same underlying memory region. If buffer implementations implement pooling then they must ensure proper release of shared buffer regions once both buffers no longer reference them.

Parameters

offset The offset to split beyond the current read offset

Returns: A new buffer that access the front portion of the buffer split

Implements Apache.Qpid.Proton.Buffer.IProtonBuffer.

◆ ReadUnsignedByte()

byte Apache.Qpid.Proton.Buffer.ProtonCompositeBuffer.ReadUnsignedByte ( )

inline

Read a unsigned byte from the buffer and advance the read offset.

Returns: The value read from the buffer

Exceptions

IndexOutOfRangeException If the buffer has no more readable bytes

Implements Apache.Qpid.Proton.Buffer.IProtonBufferAccessors.

◆ ReadUnsignedInt()

uint Apache.Qpid.Proton.Buffer.ProtonCompositeBuffer.ReadUnsignedInt ( )

inline

Reads the next four bytes from the buffer and returns the unsigned int value.

Returns: the unsigned int value at the given index

Exceptions

IndexOutOfRangeException If there are not enough readable bytes

Implements Apache.Qpid.Proton.Buffer.IProtonBufferAccessors.

◆ ReadUnsignedLong()

ulong Apache.Qpid.Proton.Buffer.ProtonCompositeBuffer.ReadUnsignedLong ( )

inline

Reads the next eight bytes from the buffer and returns the unsigned long value.

Returns: the unsigned long value at the given index

Exceptions

IndexOutOfRangeException If there are not enough readable bytes

Implements Apache.Qpid.Proton.Buffer.IProtonBufferAccessors.

◆ ReadUnsignedShort()

ushort Apache.Qpid.Proton.Buffer.ProtonCompositeBuffer.ReadUnsignedShort ( )

inline

Reads the next two bytes from the buffer and returns the unsigned short value.

Returns: the unsigned short value at the given index

Exceptions

IndexOutOfRangeException If there are not enough readable bytes

Implements Apache.Qpid.Proton.Buffer.IProtonBufferAccessors.

◆ Reclaim()

IProtonBuffer Apache.Qpid.Proton.Buffer.ProtonCompositeBuffer.Reclaim ( )

inline

Reclaims read buffer space and returns it to the operating system or other pooling mechanisms if those are in place, then compacts the remaining buffer contents. For a non-composite buffer this operation could consist of allocating a smaller buffer to house any remaining unread bytes and freeing the larger backing buffer in some cases or it may result in a no-op depending on the buffer implementation. For the composite buffer case this operation provides an API which allows for fully read buffer constituents to be released and returned to a memory pool or back to the O/S.

Returns: this buffer instance

Implements Apache.Qpid.Proton.Buffer.IProtonBuffer.

◆ Reset()

IProtonBuffer Apache.Qpid.Proton.Buffer.ProtonCompositeBuffer.Reset ( )

inline

Resets the read and write offset values to zero.

Returns: This buffer instance.

Implements Apache.Qpid.Proton.Buffer.IProtonBuffer.

◆ SetBoolean()

IProtonBuffer Apache.Qpid.Proton.Buffer.ProtonCompositeBuffer.SetBoolean	(	long	index,
		bool	value
	)

inline

Write the given boolean value at the given location in the buffer backing store without modifying the write offset of this buffer.

Parameters

index	The index in the buffer where the write should occur
value	The value to be written at the specified index

Returns: this buffer instance

Exceptions

IndexOutOfRangeException If the index is negative or larger than buffer capacity

Implements Apache.Qpid.Proton.Buffer.IProtonBufferAccessors.

◆ SetByte()

IProtonBuffer Apache.Qpid.Proton.Buffer.ProtonCompositeBuffer.SetByte	(	long	index,
		sbyte	value
	)

inline

Write the given byte value at the given location in the buffer backing store without modifying the write offset of this buffer.

Parameters

index	The index in the buffer where the write should occur
value	The value to be written at the specified index

Returns: this buffer instance

Exceptions

IndexOutOfRangeException If the index is negative or larger than buffer capacity

Implements Apache.Qpid.Proton.Buffer.IProtonBufferAccessors.

◆ SetChar()

IProtonBuffer Apache.Qpid.Proton.Buffer.ProtonCompositeBuffer.SetChar	(	long	index,
		char	value
	)

inline

Write the given 2 byte char value at the given location in the buffer backing store without modifying the write offset of this buffer.

Parameters

index	The index in the buffer where the write should occur
value	The value to be written at the specified index

Returns: this buffer instance

Exceptions

IndexOutOfRangeException If the index is negative or larger than buffer capacity

Implements Apache.Qpid.Proton.Buffer.IProtonBufferAccessors.

◆ SetDouble()

IProtonBuffer Apache.Qpid.Proton.Buffer.ProtonCompositeBuffer.SetDouble	(	long	index,
		double	value
	)

inline

Write the given 8 byte double value at the given location in the buffer backing store without modifying the write offset of this buffer.

Parameters

index	The index in the buffer where the write should occur
value	The value to be written at the specified index

Returns: this buffer instance

Exceptions

IndexOutOfRangeException If the index is negative or larger than buffer capacity

Implements Apache.Qpid.Proton.Buffer.IProtonBufferAccessors.

◆ SetFloat()

IProtonBuffer Apache.Qpid.Proton.Buffer.ProtonCompositeBuffer.SetFloat	(	long	index,
		float	value
	)

inline

Write the given 4 byte float value at the given location in the buffer backing store without modifying the write offset of this buffer.

Parameters

index	The index in the buffer where the write should occur
value	The value to be written at the specified index

Returns: this buffer instance

Exceptions

IndexOutOfRangeException If the index is negative or larger than buffer capacity

Implements Apache.Qpid.Proton.Buffer.IProtonBufferAccessors.

◆ SetInt()

IProtonBuffer Apache.Qpid.Proton.Buffer.ProtonCompositeBuffer.SetInt	(	long	index,
		int	value
	)

inline

Write the given 4 byte int value at the given location in the buffer backing store without modifying the write offset of this buffer.

Parameters

index	The index in the buffer where the write should occur
value	The value to be written at the specified index

Returns: this buffer instance

Exceptions

IndexOutOfRangeException If the index is negative or larger than buffer capacity

Implements Apache.Qpid.Proton.Buffer.IProtonBufferAccessors.

◆ SetLong()

IProtonBuffer Apache.Qpid.Proton.Buffer.ProtonCompositeBuffer.SetLong	(	long	index,
		long	value
	)

inline

Write the given 8 byte long value at the given location in the buffer backing store without modifying the write offset of this buffer.

Parameters

index	The index in the buffer where the write should occur
value	The value to be written at the specified index

Returns: this buffer instance

Exceptions

IndexOutOfRangeException If the index is negative or larger than buffer capacity

Implements Apache.Qpid.Proton.Buffer.IProtonBufferAccessors.

◆ SetShort()

IProtonBuffer Apache.Qpid.Proton.Buffer.ProtonCompositeBuffer.SetShort	(	long	index,
		short	value
	)

inline

Write the given 2 byte short value at the given location in the buffer backing store without modifying the write offset of this buffer.

Parameters

index	The index in the buffer where the write should occur
value	The value to be written at the specified index

Returns: this buffer instance

Exceptions

IndexOutOfRangeException If the index is negative or larger than buffer capacity

Implements Apache.Qpid.Proton.Buffer.IProtonBufferAccessors.

◆ SetUnsignedByte()

IProtonBuffer Apache.Qpid.Proton.Buffer.ProtonCompositeBuffer.SetUnsignedByte	(	long	index,
		byte	value
	)

inline

Write the given unsigned byte value at the given location in the buffer backing store without modifying the write offset of this buffer.

Parameters

index	The index in the buffer where the write should occur
value	The value to be written at the specified index

Returns: this buffer instance

Exceptions

IndexOutOfRangeException If the index is negative or larger than buffer capacity

Implements Apache.Qpid.Proton.Buffer.IProtonBufferAccessors.

◆ SetUnsignedInt()

IProtonBuffer Apache.Qpid.Proton.Buffer.ProtonCompositeBuffer.SetUnsignedInt	(	long	index,
		uint	value
	)

inline

Write the given 4 byte unsigned int value at the given location in the buffer backing store without modifying the write offset of this buffer.

Parameters

index	The index in the buffer where the write should occur
value	The value to be written at the specified index

Returns: this buffer instance

Exceptions

IndexOutOfRangeException If the index is negative or larger than buffer capacity

Implements Apache.Qpid.Proton.Buffer.IProtonBufferAccessors.

◆ SetUnsignedLong()

IProtonBuffer Apache.Qpid.Proton.Buffer.ProtonCompositeBuffer.SetUnsignedLong	(	long	index,
		ulong	value
	)

inline

Write the given 8 byte unsigned long value at the given location in the buffer backing store without modifying the write offset of this buffer.

Parameters

index	The index in the buffer where the write should occur
value	The value to be written at the specified index

Returns: this buffer instance

Exceptions

IndexOutOfRangeException If the index is negative or larger than buffer capacity

Implements Apache.Qpid.Proton.Buffer.IProtonBufferAccessors.

◆ SetUnsignedShort()

IProtonBuffer Apache.Qpid.Proton.Buffer.ProtonCompositeBuffer.SetUnsignedShort	(	long	index,
		ushort	value
	)

inline

Write the given 2 byte unsigned short value at the given location in the buffer backing store without modifying the write offset of this buffer.

Parameters

index	The index in the buffer where the write should occur
value	The value to be written at the specified index

Returns: this buffer instance

Exceptions

IndexOutOfRangeException If the index is negative or larger than buffer capacity

Implements Apache.Qpid.Proton.Buffer.IProtonBufferAccessors.

◆ SkipBytes()

IProtonBuffer Apache.Qpid.Proton.Buffer.ProtonCompositeBuffer.SkipBytes ( long amount )

inline

Advance the buffer read offset by the specified amount effectively skipping that number of bytes from being read.

Parameters

amount The number of bytes to skip

Returns: this buffer instance

Exceptions

IndexOutOfRangeException If the amount is negative or larger than readable size

Implements Apache.Qpid.Proton.Buffer.IProtonBuffer.

◆ Split() [1/2]

IProtonBuffer Apache.Qpid.Proton.Buffer.ProtonCompositeBuffer.Split ( )

inline

Splits the buffer into two buffers at the write offset. The resulting buffer will comprise the read and readable portions of this buffer with the write offset and capacity set to the current write offset. This buffer will lose access to the split region and its read offset will be set to the current write offset. This buffer will also have its capacity reduced by the number of bytes in the returned buffer (i.e. the current number of read and readable bytes). Split buffers support the standard buffer operations including resizing to ensure writable regions which implies that a buffer resize on either will cause them to no longer reference the same underlying memory region. If buffer implementations implement pooling then they must ensure proper release of shared buffer regions once both buffers no longer reference them.

Returns: A new buffer that access the front portion of the buffer split

Implements Apache.Qpid.Proton.Buffer.IProtonBuffer.

◆ Split() [2/2]

IProtonBuffer Apache.Qpid.Proton.Buffer.ProtonCompositeBuffer.Split ( long index )

inline

Splits the buffer into two distinct buffers at the given index. The returned buffer will retain the read offset and write offset of this buffer but will be truncated to match the capacity provided by the split index, which implies that they might both be set to the capacity if they were previously set beyond the split index. The returned buffer will set its read and write offsets to zero if they fell prior to the given index otherwise they will be truncated to match the new buffer capacity. Split buffers support the standard buffer operations including resizing to ensure writable regions which implies that a buffer resize on either will cause them to no longer reference the same underlying memory region. If buffer implementations implement pooling then they must ensure proper release of shared buffer regions once both buffers no longer reference them.

Parameters

index The index in this buffer where the split occurs

Returns: A new buffer that access the front portion of the buffer split

Implements Apache.Qpid.Proton.Buffer.IProtonBuffer.

◆ ToString()

string Apache.Qpid.Proton.Buffer.ProtonCompositeBuffer.ToString ( Encoding encoding )

inline

Coverts the readable bytes in this buffer into a string value using the Encoding value provided. The underlying read and write offset values are not modified as a result of this operation.

Parameters

encoding The encoding to use to convert the readable bytes

Returns: The string value of the readable bytes as converted by the provided Encoding

Implements Apache.Qpid.Proton.Buffer.IProtonBuffer.

◆ WriteBoolean()

IProtonBuffer Apache.Qpid.Proton.Buffer.ProtonCompositeBuffer.WriteBoolean ( bool value )

inline

Writes the given boolean value into this buffer as a single byte and increases the write offset.

Parameters

value The value to write into this buffer

Returns: this buffer instance

Exceptions

IndexOutOfRangeException If there are not enough writable bytes

Implements Apache.Qpid.Proton.Buffer.IProtonBufferAccessors.

◆ WriteByte()

IProtonBuffer Apache.Qpid.Proton.Buffer.ProtonCompositeBuffer.WriteByte ( sbyte value )

inline

Writes the given byte value into this buffer and increases the write offset.

Parameters

value The value to write into this buffer

Returns: this buffer instance

Exceptions

IndexOutOfRangeException If there are not enough writable bytes

Implements Apache.Qpid.Proton.Buffer.IProtonBufferAccessors.

◆ WriteBytes() [1/3]

IProtonBuffer Apache.Qpid.Proton.Buffer.ProtonCompositeBuffer.WriteBytes ( byte[] source )

inline

Writes the contents of the given byte array into this buffer and advances the write offset by the number of bytes written.

Parameters

source The byte buffer to be written into this buffer

Returns: this buffer instance

Exceptions

IndexOutOfRangeException If there are not enough writable bytes

Implements Apache.Qpid.Proton.Buffer.IProtonBuffer.

◆ WriteBytes() [2/3]

IProtonBuffer Apache.Qpid.Proton.Buffer.ProtonCompositeBuffer.WriteBytes	(	byte[]	source,
		long	offset,
		long	length
	)

inline

Writes the contents of the given byte array into this buffer and advances the write offset by the number of bytes written.

Parameters

source	The byte buffer to be written into this buffer
offset	The offset into the source buffer to start the write
length	The number of bytes from the source buffer to write into this buffer

Returns: this buffer instance

Exceptions

IndexOutOfRangeException If there are not enough writable bytes

Implements Apache.Qpid.Proton.Buffer.IProtonBuffer.

◆ WriteBytes() [3/3]

IProtonBuffer Apache.Qpid.Proton.Buffer.ProtonCompositeBuffer.WriteBytes ( IProtonBuffer source )

inline

Transfers the bytes from the source buffer to this buffer starting at the current write offset and continues until the source buffer becomes unreadable. The write index of this buffer is increased by the number of bytes read from the source. The method also increases the read offset of the source by the same amount as was written.

Parameters

source	The byte buffer to be written into this buffer
length	The number of bytes to write into this buffer

Returns: this buffer instance

Exceptions

IndexOutOfRangeException If there are not enough writable bytes

Implements Apache.Qpid.Proton.Buffer.IProtonBuffer.

◆ WriteDouble()

IProtonBuffer Apache.Qpid.Proton.Buffer.ProtonCompositeBuffer.WriteDouble ( double value )

inline

Writes the given eight byte double value into this buffer and increases the write offset.

Parameters

value The value to write into this buffer

Returns: this buffer instance

Exceptions

IndexOutOfRangeException If there are not enough writable bytes

Implements Apache.Qpid.Proton.Buffer.IProtonBufferAccessors.

◆ WriteFloat()

IProtonBuffer Apache.Qpid.Proton.Buffer.ProtonCompositeBuffer.WriteFloat ( float value )

inline

Writes the given four byte float value into this buffer and increases the write offset.

Parameters

value The value to write into this buffer

Returns: this buffer instance

Exceptions

IndexOutOfRangeException If there are not enough writable bytes

Implements Apache.Qpid.Proton.Buffer.IProtonBufferAccessors.

◆ WriteInt()

IProtonBuffer Apache.Qpid.Proton.Buffer.ProtonCompositeBuffer.WriteInt ( int value )

inline

Writes the given four byte int value into this buffer and increases the write offset.

Parameters

value The value to write into this buffer

Returns: this buffer instance

Exceptions

IndexOutOfRangeException If there are not enough writable bytes

Implements Apache.Qpid.Proton.Buffer.IProtonBufferAccessors.

◆ WriteLong()

IProtonBuffer Apache.Qpid.Proton.Buffer.ProtonCompositeBuffer.WriteLong ( long value )

inline

Writes the given eight byte long value into this buffer and increases the write offset.

Parameters

value The value to write into this buffer

Returns: this buffer instance

Exceptions

IndexOutOfRangeException If there are not enough writable bytes

Implements Apache.Qpid.Proton.Buffer.IProtonBufferAccessors.

◆ WriteShort()

IProtonBuffer Apache.Qpid.Proton.Buffer.ProtonCompositeBuffer.WriteShort ( short value )

inline

Writes the given two byte short value into this buffer and increases the write offset.

Parameters

value The value to write into this buffer

Returns: this buffer instance

Exceptions

IndexOutOfRangeException If there are not enough writable bytes

Implements Apache.Qpid.Proton.Buffer.IProtonBufferAccessors.

◆ WriteSplit()

IProtonBuffer Apache.Qpid.Proton.Buffer.ProtonCompositeBuffer.WriteSplit ( long offset )

inline

Splits the buffer into two distinct buffers at the given index plus the current write offset. The returned buffer will retain the read offset and write offset of this buffer but will be truncated to match the capacity provided by the split index, which implies that they might both be set to the capacity if they were previously set to the split index. The returned buffer will set its read and write offsets to zero if they fell prior to the given index otherwise they will be truncated to match the new buffer capacity. Split buffers support the standard buffer operations including resizing to ensure writable regions which implies that a buffer resize on either will cause them to no longer reference the same underlying memory region. If buffer implementations implement pooling then they must ensure proper release of shared buffer regions once both buffers no longer reference them.

Parameters

offset The offset to split beyond the current write offset

Returns: A new buffer that access the front portion of the buffer split

Implements Apache.Qpid.Proton.Buffer.IProtonBuffer.

◆ WriteUnsignedByte()

IProtonBuffer Apache.Qpid.Proton.Buffer.ProtonCompositeBuffer.WriteUnsignedByte ( byte value )

inline

Writes the given unsigned byte value into this buffer and increases the write offset.

Parameters

value The value to write into this buffer

Returns: this buffer instance

Exceptions

IndexOutOfRangeException If there are not enough writable bytes

Implements Apache.Qpid.Proton.Buffer.IProtonBufferAccessors.

◆ WriteUnsignedInt()

IProtonBuffer Apache.Qpid.Proton.Buffer.ProtonCompositeBuffer.WriteUnsignedInt ( uint value )

inline

Writes the given four byte unsigned int value into this buffer and increases the write offset.

Parameters

value The value to write into this buffer

Returns: this buffer instance

Exceptions

IndexOutOfRangeException If there are not enough writable bytes

Implements Apache.Qpid.Proton.Buffer.IProtonBufferAccessors.

◆ WriteUnsignedLong()

IProtonBuffer Apache.Qpid.Proton.Buffer.ProtonCompositeBuffer.WriteUnsignedLong ( ulong value )

inline

Writes the given eight byte unsigned long value into this buffer and increases the write offset.

Parameters

value The value to write into this buffer

Returns: this buffer instance

Exceptions

IndexOutOfRangeException If there are not enough writable bytes

Implements Apache.Qpid.Proton.Buffer.IProtonBufferAccessors.

◆ WriteUnsignedShort()

IProtonBuffer Apache.Qpid.Proton.Buffer.ProtonCompositeBuffer.WriteUnsignedShort ( ushort value )

inline

Writes the given two byte unsigned short value into this buffer and increases the write offset.

Parameters

value The value to write into this buffer

Returns: this buffer instance

Exceptions

IndexOutOfRangeException If there are not enough writable bytes

Implements Apache.Qpid.Proton.Buffer.IProtonBufferAccessors.

Property Documentation

◆ Capacity

long Apache.Qpid.Proton.Buffer.ProtonCompositeBuffer.Capacity

get

Gets the current capacity of this buffer instance which is the total amount of bytes that could be written before additional buffer capacity would be needed to allow more buffer writes. The remaining amount of writable bytes at any given time is the buffer capacity minus the write offset.

Implements Apache.Qpid.Proton.Buffer.IProtonBuffer.

◆ ComponentCount

uint Apache.Qpid.Proton.Buffer.ProtonCompositeBuffer.ComponentCount

get

Returns the number of component buffers in this buffer. If this is not a composite buffer instance then the count will always be one. For a composite buffer this will be the count of the current number of component buffers contained within.

Implements Apache.Qpid.Proton.Buffer.IProtonBuffer.

◆ IsReadable

bool Apache.Qpid.Proton.Buffer.ProtonCompositeBuffer.IsReadable

get

Returns true if the current read offset is less than the current write offset meaning there are bytes available for reading.

Implements Apache.Qpid.Proton.Buffer.IProtonBuffer.

◆ IsWritable

bool Apache.Qpid.Proton.Buffer.ProtonCompositeBuffer.IsWritable

get

Returns true if write offset is less than the current buffer capacity limit.

Implements Apache.Qpid.Proton.Buffer.IProtonBuffer.

◆ ReadableBytes

long Apache.Qpid.Proton.Buffer.ProtonCompositeBuffer.ReadableBytes

get

Returns the number of bytes that can currently be read from this buffer.

Implements Apache.Qpid.Proton.Buffer.IProtonBuffer.

◆ ReadableComponentCount

uint Apache.Qpid.Proton.Buffer.ProtonCompositeBuffer.ReadableComponentCount

get

Returns the number of component buffers in this buffer that are readable and would be provided to calls to the for each readable buffer API. If this is not a composite buffer instance then the count will be at most one. For a composite buffer this will be the count of the current number of component buffers contained within that are readable.

Implements Apache.Qpid.Proton.Buffer.IProtonBuffer.

◆ ReadOffset

long Apache.Qpid.Proton.Buffer.ProtonCompositeBuffer.ReadOffset

getset

Gets or sets the current read offset in this buffer. If the read offset is set to a value larger than the current write offset an exception is thrown.

Implements Apache.Qpid.Proton.Buffer.IProtonBuffer.

◆ WritableBytes

long Apache.Qpid.Proton.Buffer.ProtonCompositeBuffer.WritableBytes

get

Returns the number of bytes that can currently be written from this buffer.

Implements Apache.Qpid.Proton.Buffer.IProtonBuffer.

◆ WritableComponentCount

uint Apache.Qpid.Proton.Buffer.ProtonCompositeBuffer.WritableComponentCount

get

Returns the number of component buffers in this buffer that are writable and would be provided to calls to the for each writable buffer API. If this is not a composite buffer instance then the count will be at most one. For a composite buffer this will be the count of the current number of component buffers contained within that are writable.

Implements Apache.Qpid.Proton.Buffer.IProtonBuffer.

◆ WriteOffset

long Apache.Qpid.Proton.Buffer.ProtonCompositeBuffer.WriteOffset

getset

Gets or sets the current write offset in this buffer. If the write offset is set to a value less than the current read offset or larger than the current buffer capacity an exception is thrown.

Implements Apache.Qpid.Proton.Buffer.IProtonBuffer.

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

src/Proton/Buffer/ProtonCompositeBuffer.cs

Public Member Functions

Properties

Additional Inherited Members

Detailed Description

Member Function Documentation

◆ Append()

◆ Compact()

◆ Copy() [1/2]

◆ Copy() [2/2]

◆ CopyInto() [1/2]

◆ CopyInto() [2/2]

◆ DecomposeBuffer()

◆ EnsureWritable()

◆ Fill()

◆ ForEachReadableComponent()

◆ ForEachWritableComponent()

◆ GetBoolean()

◆ GetByte()

◆ GetChar()

◆ GetDouble()

◆ GetFloat()

◆ GetInt()

◆ GetLong()

◆ GetShort()

◆ GetUnsignedByte()

◆ GetUnsignedInt()

◆ GetUnsignedLong()

◆ GetUnsignedShort()

◆ ReadBoolean()

◆ ReadByte()

◆ ReadChar()

◆ ReadDouble()

◆ ReadFloat()

◆ ReadInt()

◆ ReadLong()

◆ ReadShort()

◆ ReadSplit()

◆ ReadUnsignedByte()

◆ ReadUnsignedInt()

◆ ReadUnsignedLong()

◆ ReadUnsignedShort()

◆ Reclaim()

◆ Reset()

◆ SetBoolean()

◆ SetByte()

◆ SetChar()

◆ SetDouble()

◆ SetFloat()

◆ SetInt()

◆ SetLong()

◆ SetShort()

◆ SetUnsignedByte()

◆ SetUnsignedInt()

◆ SetUnsignedLong()

◆ SetUnsignedShort()

◆ SkipBytes()

◆ Split() [1/2]

◆ Split() [2/2]

◆ ToString()

◆ WriteBoolean()

◆ WriteByte()

◆ WriteBytes() [1/3]

◆ WriteBytes() [2/3]

◆ WriteBytes() [3/3]

◆ WriteDouble()

◆ WriteFloat()

◆ WriteInt()

◆ WriteLong()

◆ WriteShort()

◆ WriteSplit()

◆ WriteUnsignedByte()

◆ WriteUnsignedInt()

◆ WriteUnsignedLong()

◆ WriteUnsignedShort()

Property Documentation

◆ Capacity

◆ ComponentCount

◆ IsReadable

◆ IsWritable

◆ ReadableBytes