table.copy
| Syntax |
table.copy (sourceAddr, destAddr)
|
| Params |
sourceAddr is the Object Database address of the object to be copied. destAddr is the Object Database address of the table to which the object at sourceaddr is to be copied.
|
| Action |
Copies an object to a table.
|
| Returns |
True
|
| Examples |
The examples table contains a table called table1 with four entries: a string, a number, a script, and an outline. It also has an empty table called table2. The following line copies the outline from table1 into table2: table.copy(@examples.table1.entry4,@examples.table2)
Select table2 in the table window and you'll see that it now has one item. Open it and you'll see that its one item is called entry4 and that it has the same contents as examples.table1.entry4. |
| Errors |
Attempting to copy a table to a non-existent destAddr results in an error. If destAddr contains any object other than a table, an error message is generated.
|
| Notes |
This verb can be used to copy any object to a table. The object being copied can even be itself a table, in which case it is inserted into the destination table at destAddr as a sub-table.
|
| See Also |
table.copyContents
|
