fremove - Maple Programming Help

Online Help

All Products    Maple    MapleSim


Home : Support : Online Help : Programming : Input and Output : File Manipulation : fremove

fremove

remove a file

 

Calling Sequence

Parameters

Description

Thread Safety

Examples

Calling Sequence

fremove(file ...)

Parameters

file

-

one or more file names or descriptors

Description

• 

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.

Thread Safety

• 

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.

Examples

fprintf(testFile,"This is a test\n");   # Write the file

15

(1)

filepos(testFile,0);                    # Rewind it

0

(2)

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