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

# Builtins.createString(3kaya)

Creates a string with particular memory allocation

## NAME

Builtins::createString - Creates a string with particular memory allocation

## SYNOPSIS

**String createString(** *Int len* **)**

## ARGUMENTS

**len** The number of characters to allocate space for

## DESCRIPTION

Create an empty string, with initial space for *len* characters. Use this to avoid unnecessary reallocation if you know or can compute the length of a string in advance.

Using this function can save time and memory in Kaya programs, but generally the default memory allocation will be adequate - save this for the optimisation stage.

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

**Array.createArray (3kaya)**