File: deleteFile.html

package info (click to toggle)
sludge 2.2.2-5
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid, trixie
  • size: 6,852 kB
  • sloc: cpp: 32,432; sh: 1,237; makefile: 634; xml: 284
file content (62 lines) | stat: -rwxr-xr-x 1,586 bytes parent folder | download | duplicates (7)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd">
<html>
<head>
<TITLE>deleteFile</TITLE>
  <link rel="stylesheet" type="text/css" href="style.css" />
</head>
<BODY>
<HR>
<div align="center"><img id="headerGraphic" src="images/sludge300.png" alt="SLUDGE"/></div>
<h2>deleteFile</h2>
<HR>

<H3>Syntax:</H3>

<P>
<pre class="syntax">deleteFile (<i>thisFilename</i>);</pre>
</P>

<H3>Purpose:</H3>

<P>
Deletes the file specified by <i>thisFilename</i> - which should be a string, not a file handle. If you're writing a custom save game mechanism, you may require this functionality... so here it is. The string <i>thisFilename</i> shouldn't contain any of the characters &quot;:&quot;, &quot;/&quot; and &quot;\&quot; - a precaution to make it more difficult to write malicious code.
</P>

<P>
This function supports filename bodging - for details see the <a href="bodgeFilenames.html">bodgeFilenames</a> command.
</P>

<H3>Return value:</H3>

<P>
The command returns TRUE if the deletion was a success, FALSE otherwise.
</P>

<H3>See also: </H3>

<P>
<a href="fileExists.html">fileExists</a>
</P>

<P>
<a href="getMatchingFiles.html">getMatchingFiles</a>
</P>

<P>
<a href="loadGame.html">loadGame</a>
</P>

<P>
<a href="saveGame.html">saveGame</a>
</P>

<P>
<a href="renameFile.html">renameFile</a>
</P>

<P class="copyright-notice">SLUDGE and this SLUDGE documentation are <A HREF="Copyright.html">copyright</A> Hungry Software and contributors 2000-2012
</P>

<HR>
</BODY>
</html>