<p>The f_truncate function truncates the file size.</p>
16
<pre>
17
FRESULT f_truncate (
18
FIL* <em>FileObject</em> /* Pointer to the file object */
19
);
20
</pre>
21
</div>
22
23
<div class="para">
24
<h4>Parameter</h4>
25
<dl class="par">
26
<dt>FileObject</dt>
27
<dd>Pointer to the open file object to be truncated.</dd>
28
</dl>
29
</div>
30
31
32
<div class="para">
33
<h4>Return Values</h4>
34
<dl class="ret">
35
<dt>FR_OK (0)</dt>
36
<dd>The function succeeded.</dd>
37
<dt>FR_DENIED</dt>
38
<dd>The file has been opened in read-only mode.</dd>
39
<dt>FR_DISK_ERR</dt>
40
<dd>The function failed due to an error in the disk function.</dd>
41
<dt>FR_INT_ERR</dt>
42
<dd>The function failed due to a wrong FAT structure or an internal error.</dd>
43
<dt>FR_NOT_READY</dt>
44
<dd>The disk drive cannot work due to no medium in the drive or any other reason.</dd>
45
<dt>FR_INVALID_OBJECT</dt>
46
<dd>The file object is invalid.</dd>
47
</dl>
48
</div>
49
50
51
<div class="para">
52
<h4>Description</h4>
53
<p>The f_truncate function truncates the file size to the current file R/W point. When the file R/W pointer is already pointing end of the file, this function has no effect.</p>
54
</div>
55
56
57
<div class="para">
58
<h4>QuickInfo</h4>
59
<p>Available when <tt>_FS_READONLY == 0</tt> and <tt>_FS_MINIMIZE == 0</tt>.</p>
