fremove
remove a file
Calling Sequence
Parameters
Description
Thread Safety
Examples
fremove(file ...)
file
-
one or more file names or descriptors
The specified files are closed if they were open, and then removed.
If the user does not have the necessary permissions to remove a file, an error is generated.
fremove does not return anything.
The only way to ensure that a file is empty before starting to write to it is to call fremove to remove it first. This will raise an exception if the file does not exist, but this exception can be caught.
The fremove command is thread safe as of Maple 15. Be careful removing files that could be in use by parallel threads.
Parallel calls to file i/o commands on the same file descriptor will be serialized in an arbitrary order. If you need the commands to execute in a particular order you must use Maple's synchronization tools to enforce this. See Threads:-Mutex.
For more information on thread safety, see index/threadsafe.
fprintf(testFile,"This is a test\n"); # Write the file
15
filepos(testFile,0); # Rewind it
0
readline(testFile); # Read it back
This is a test
fremove(testFile); # Remove it
readline(testFile); # Show that it is gone
Error, (in readline) file or directory does not exist
fremove(testFile); # Remove it again
Error, (in fremove) file or directory does not exist
try fremove(testFile) catch: end try: # Do it quietly
See Also
file_types
FileTools[Remove]
IO_errors
rmdir
Download Help Document