Kaya 0.4.4 reference for Binary::setBlockData

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 Ints

Usage

Set the contents of (part of) a block from an array. An OffsetOutOfRange 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).

Related

• Binary
• array
• copyBlock
• getBlockChunk
• poke
• pokeString