---
name: "Binary.pokeString"
section: "3kaya"
platform: "linux"
package: "kaya"
version: "0.4.4-6.2"
release: "Debian 8 (Jessie)"
platforms: ["linux"]
url: "https://new.carta.tech/Binary.pokeString"
---

# Binary.pokeString(3kaya)

Write a String of binary data.

## 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)**