/// <summary>
/// Appends blocks from a block array to this array.
/// </summary>
/// <param name="blocks">The source array.</param>
/// <param name="index">Index of the first block to append.</param>
/// <param name="count">Number of blocks to append.</param>
public void Append(BlockArray blocks, int index, int count)
{
for (int i = index; i < count + index; i++)
{
Append(blocks.GetBlock(i));
}
}
/// <summary>
/// Appends all blocks from a block array to this array.
/// </summary>
/// <param name="blocks">The source array.</param>
public void Append(BlockArray blocks)
{
for (int i = 0; i < blocks.Count; i++)
{
Append(blocks.GetBlock(i));
}
}
/// <summary>
/// Extracts a range of bytes from the array into newly
/// created block array.
/// </summary>
/// <param name="index">Logical index of the first byte.</param>
/// <param name="length">Number of bytes to extract.</param>
/// <returns>A new block array referencing the bytes.</returns>
/// <remarks>
/// <note>
/// Although this method does create a new BlockArray
/// and Block objects, it does not copy the underlying buffers.
/// Instead, it adjusts the new Block objects to reference the
/// requested portions of the original underlying buffers.
/// </note>
/// </remarks>
public BlockArray Extract(int index, int length)
{
BlockArray extracted = new BlockArray();
int cbRemain;
int blockIndex;
int pos;
int cb;
Block srcBlock;
Block dstBlock;
if (length <= 0)
{
return(extracted);
}
if (index + length > size)
{
throw new IndexOutOfRangeException();
}
if (index == 0 && length == size)
{
// Return a clone of this instance.
for (int i = 0; i < list.Count; i++)
{
srcBlock = list[i];
extracted.Append(new Block(srcBlock.Buffer, srcBlock.Offset, srcBlock.Length));
}
return(extracted);
}
CalcPos(index);
cbRemain = length;
blockIndex = lastBlockIndex;
srcBlock = list[blockIndex];
pos = lastBlockPos + srcBlock.Offset;
while (true)
{
cb = srcBlock.Length + srcBlock.Offset - pos;
if (cb > cbRemain)
{
cb = cbRemain;
}
dstBlock = new Block(srcBlock.Buffer, pos, cb);
extracted.Append(dstBlock);
cbRemain -= cb;
if (cbRemain <= 0)
{
break;
}
srcBlock = list[++blockIndex];
pos = srcBlock.Offset;
}
return(extracted);
}