DispatchDataMBS.Concat(other as DispatchDataMBS) as DispatchDataMBS

Var m1 As MemoryBlock = "Hello"
Var m2 As MemoryBlock = "World"

Var d1 As New DispatchDataMBS(m1)
Var d2 As New DispatchDataMBS(m2)

Var d As DispatchDataMBS = d1.Concat(d2)
Var m As MemoryBlock = d.CopyData

// shows HelloWorld
MessageBox m.StringValue(0, m.size)

Those objects may be released by the application after the call returns (however, the system might not deallocate the memory region(s) described by them until the newly created object has also been released).

DispatchDataMBS.Constructor(data as DispatchDataMBS)

Creates a new Xojo object referencing the same dispatch data.

See also:

• Constructor(data as MemoryBlock, copy as boolean = false)
• Constructor(data as Ptr, Length as Integer)

DispatchDataMBS.Constructor(data as MemoryBlock, copy as boolean = false)

If copy is true, we make a copy of the content of the MemoryBlock.
If copy is false, we reference the MemoryBlock to avoid the copy.

See also:

• Constructor(data as DispatchDataMBS)
• Constructor(data as Ptr, Length as Integer)

DispatchDataMBS.Constructor(data as Ptr, Length as Integer)

If there is a parent object for the MemoryBlock, you can store it in ReferencedMemory property or any other thing in the tag property.

See also:

• Constructor(data as DispatchDataMBS)
• Constructor(data as MemoryBlock, copy as boolean = false)

DispatchDataMBS.CopyData as MemoryBlock

DispatchDataMBS.SubRange(offset as UInt64, length as UInt64) as DispatchDataMBS

Returns a new dispatch data object representing a subrange of the specified data object, which may be released by the application after the call returns (however, the system might not deallocate the memory region(s) described by that object until the newly created object has also been released).

offset: The offset into the data object where the subrange starts.
length: The length of the range.

Returns a newly created object representing the specified subrange of the data object.