NAME

       Binary::setBlockData - Set the contents of a block.

SYNOPSIS

       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

DESCRIPTION

       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)

AUTHORS

       Kaya standard library by Edwin Brady, Chris Morris  and  others  (kaya@kayalang.org).  For
       further information see http://kayalang.org/

LICENSE

       The Kaya standard library is free software; you can redistribute it and/or modify it under
       the terms of the GNU Lesser General Public License (version 2.1 or any later  version)  as
       published by the Free Software Foundation.

RELATED

       Binary.Binary (3kaya)
       Binary.array (3kaya)
       Binary.copyBlock (3kaya)
       Binary.getBlockChunk (3kaya)
       Binary.poke (3kaya)
       Binary.pokeString (3kaya)