trusty (3) Binary.setBlockData.3kaya.gz

Provided by: kaya_0.4.4-6ubuntu3_amd64 bug

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.

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