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)