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

# Binary.createBlock(3kaya)

Create a new, uninitialised block for binary data.

## NAME

Binary::createBlock - Create a new, uninitialised block for binary data.

## SYNOPSIS

**Binary createBlock(** *Int bsize* **)**

## ARGUMENTS

**bsize** The size of the block. Block sizes cannot be changed once the block is created.

## DESCRIPTION

Create a new, uninitialised block for binary data. Remember to use **Builtins.byteLength (3kaya)** instead of **Builtins.length (3kaya)** if you want to store Strings in these, as you may have problems with multi-byte characters otherwise.

The uninitialised contents of this block are not guaranteed to be zeroes.

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