Appendix A: System Routines — Symbol Table Utilities
1021
TI
-
89 / TI
-
92 Plus Developer Guide
Not for Distribution
Beta Version January 26, 2001
FolderRename
Declaration:
BOOL
FolderRename
(const BYTE *
OldName
, const BYTE *
NewName
)
Category(ies):
Symbol Table Utilities (low-level)
Description:
Rename a folder. This is the low-level folder rename routine. In general,
the routine
cmd_rename
should be used since this routine does not check
for reserved names.
Inputs:
OldName
— Pointer to tokenized original folder name.
NewName
— Pointer to tokenized new folder name.
Outputs:
Returns TRUE if successful;
OldName
was found and was a folder;
NewName
was not found, otherwise FALSE.
Will throw an ER_RESERVED error if renaming to or from MAIN.
Will throw a ER_VAR_IN_USE if any variable in the given folder is in-use.
Assumptions:
None
Side Effects:
None
Availability:
All versions of the TI
-
89 / TI
-
92 Plus.
TI
-
89 / TI
-
92 Plus
Differences:
None
See Also: cmd_rename
Example:
BYTE foldName[] = {0,'t','m','p','1',0};
BYTE newFoldName[] = {0,'t','e','m','p','1',0};
FolderAdd( foldName+5 );
.
.
.
FolderRename( foldName+5, newFoldName+6 );
To Next Page
Loading...
Need help?
General
