Folderrename - Texas Instruments TI-89 Developer's Manual

Appendix A: System Routines — Symbol Table Utilities

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
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[] =
FolderAdd( foldName+5 );
.
.
.
FolderRename( foldName+5, newFoldName+6 );
TI-89 / TI-92 Plus Developer Guide
— Pointer to tokenized original folder name.
{0,'t','e','m','p','1',0};
Not for Distribution
1021
Beta Version January 26, 2001