Maple Professional
Maple Academic
Maple Student Edition
Maple Personal Edition
Maple Player
Maple Player for iPad
MapleSim Professional
MapleSim Academic
Maple T.A. - Testing & Assessment
Maple T.A. MAA Placement Test Suite
Möbius - Online Courseware
Machine Design / Industrial Automation
Aerospace
Vehicle Engineering
Robotics
Power Industries
System Simulation and Analysis
Model development for HIL
Plant Modeling for Control Design
Robotics/Motion Control/Mechatronics
Other Application Areas
Mathematics Education
Engineering Education
High Schools & Two-Year Colleges
Testing & Assessment
Students
Financial Modeling
Operations Research
High Performance Computing
Physics
Live Webinars
Recorded Webinars
Upcoming Events
MaplePrimes
Maplesoft Blog
Maplesoft Membership
Maple Ambassador Program
MapleCloud
Technical Whitepapers
E-Mail Newsletters
Maple Books
Math Matters
Application Center
MapleSim Model Gallery
User Case Studies
Exploring Engineering Fundamentals
Teaching Concepts with Maple
Maplesoft Welcome Center
Teacher Resource Center
Student Help Center
FileTools[Rename] - rename a file
Calling Sequence
Rename(old, new, opt1)
Parameters
old
-
string; source filename
new
string; destination filename
opt1
(optional) name; argument
Description
The Rename(old, new) command moves the file old to the new location new.
The Rename function does not return anything.
The optional argument force controls Rename's behavior when a file named new exists. If force=false then an error is raised and the renaming does not occur. This is the default behavior. If force=true then the file is replaced by the renaming.
If either new or old refers to an open file, it is automatically closed before the move.
If the user does not have permission to perform the operation, an exception is raised.
Examples
The file "testfile" cannot be read because it has been renamed.
Error, (in fopen) file or directory does not exist
See Also
file_types, FileTools, FileTools[Binary][Close], FileTools[Binary][Open], FileTools[Remove], FileTools[Text][Close], FileTools[Text][Open], FileTools[Text][ReadLine], FileTools[Text][WriteLine], IO_errors
Download Help Document