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)