binary.pokestring(3kaya) [debian man page]

Binary.pokeString(3kaya)				       Kaya module reference					  Binary.pokeString(3kaya)

NAME

       Binary::pokeString - Write a String of binary data.

SYNOPSIS

       Void pokeString( var Binary block, Int offset, String val )

ARGUMENTS

       block The binary block

       offset The location to write to (starting from zero)

       val The String to write.

DESCRIPTION

       Poke the string val into the block, starting at offset offset
	An  Binary.OffsetOutOfRange(3kaya) exception will be thrown if it attempts to access a value outside the block. Note that the String will
       be stored in the block in UTF-8 encoding, not as raw Kaya chars, so you need to use Builtins.byteLength(3kaya) to determine how much space
       you need (and then add one for a terminating null byte).

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)
       Builtins.byteLength(3kaya)
       Binary.peekString(3kaya)
       Binary.poke(3kaya)
       Binary.setBlockData(3kaya)

Kaya								   October 2012 					  Binary.pokeString(3kaya)

Binary.setBlockData(3kaya)				       Kaya module reference					Binary.setBlockData(3kaya)

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  off-
       set+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)

Kaya								   October 2012 					Binary.setBlockData(3kaya)