Builtins.copy.3kaya

Langue: en

Version: March 2009 (fedora - 05/07/09)

Section: 3 (Bibliothèques de fonctions)

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.