 |
SymMove |
Function (ROM Call 0x63) |
Moves a symbol.
SymMove moves the symbol SrcName to the symbol DestName
(see SymFind for rules about SrcName and DestName).
Both SrcName and DestName may also contain a folder name together with the
symbol name (separated by "\"). If none of the names does not contain a folder name,
moving will be simply reduced to renaming. If the destination folder does not exist, a dialog
will appear which asks the user whether a new folder will be created. If the answer is "NO", a
"Folder" error will be thrown. Destination symbol will be deleted before moving, if such
symbol exists. SymMove returns TRUE if the operation was successful,
else returns FALSE. This function will even move and rename
locked and archived files; however, upon a reset, they will return to the original name and/or
folder.
Note: Check whether SrcName exists before applying this command, because the
destination symbol DestName (if exists) will be deleted even in a case of an error!
Uses: SymDel, SymFindPtr, CheckGraphRef, ROM Call 0x439
Used by: cmd_movevar, rename, ROM Call 0x437