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)

Kaya                                                July 2013                       Builtins.createString(3kaya)