SymMove Function (ROM Call 0x63)

vat.h

short SymMove (SYM_STR SrcName, SYM_STR DestName);

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