trusty (3) Builtins.copy.3kaya.gz

NAME

       Builtins::copy - Copy a value

SYNOPSIS

       any copy( any x )

ARGUMENTS

       x The value to copy

DESCRIPTION

       Create  a  deep  copy  of  any value.  Contrasting with assignment, which creates another reference, this
       function traverses the entire structure and creates a clone.  Note that this function  is  not  pure,  as
       even called with the same input, it returns a different copy each time.

    a = [5,6,7];
    myFunction(a); // pass by shallow copy
    myFunction(copy(a)); // pass by deep copy

       Copying  a  structure  containing a foreign pointer (for example a database or file handle, or a piece of
       binary data) will copy the pointer but will not copy the contents of that pointer.

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.