Binary.setBlockData3kaya
Set the contents of a block.
Usage
Void setBlockData( var Binary block, Int offset, [Int] bdata )
Arguments
block The binary block
offset The offset to start at (zero-indexed)
bdata The data to write, as an array of Int s
Overview
Set the contents of (part of) a block from an array. An Binary.OffsetOutOfRange (3kaya) Exception will be thrown if this would cause a write outside the bounds of the block. The following bits of code are equivalent:
-
setBlockData(block,offset,bdata);
// is equivalent to
for byte@idx in bdata {
poke(block,offset+idx,byte);
}
However, setBlockData is more efficient and checks bounds before any data is written - the above for loop could write partial data if offset+idx was greater than blockSize(block)
Releases
4 releases since Debian 5.0 (Lenny); the text changed 3 times.