fremove - Maple Programming Help

# Online Help

###### All Products    Maple    MapleSim

fremove

remove a file

 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

 > $\mathrm{fprintf}\left(\mathrm{testFile},"This is a test"\right)$
 ${15}$ (1)
 > $\mathrm{filepos}\left(\mathrm{testFile},0\right)$
 ${0}$ (2)
 > $\mathrm{readline}\left(\mathrm{testFile}\right)$

 This is a test

 > $\mathrm{fremove}\left(\mathrm{testFile}\right)$
 > $\mathrm{readline}\left(\mathrm{testFile}\right)$

 Error, (in readline) file or directory does not exist

 > $\mathrm{fremove}\left(\mathrm{testFile}\right)$

 Error, (in fremove) file or directory does not exist

 > $\mathbf{try}\phantom{\rule[-0.0ex]{0.5em}{0.0ex}}\mathrm{fremove}\left(\mathrm{testFile}\right)\phantom{\rule[-0.0ex]{0.5em}{0.0ex}}\mathbf{end try}:$

 See Also

## Was this information helpful?

 Please add your Comment (Optional) E-mail Address (Optional) What is ? This question helps us to combat spam