1<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
2<html xml:lang="en-US" lang="en-US" xmlns="http://www.w3.org/1999/xhtml">
3  <head>
4    <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
5    <meta http-equiv="Content-Style-Type" content="text/css" />
6    <link rel="stylesheet" href="../../../css/manpage.css" type="text/css" />
7<title>SetSize</title>
8  </head>
9  <body>
10<h1><CODE><a href="../../../nn/Overview.html">nn</a>::<a href="../../../nn/fs/Overview.html">fs</a>::<a href="../../../nn/fs/FileOutputStream/Overview.html">FileOutputStream</a>::SetSize</CODE> Member Function</h1>
11<h2>Syntax</h2>
12    <div class="section">
13      <pre class="definition">
14virtual void SetSize(
15     <a href="../../../nn_types/s64.html">s64</a> size
16);
17</pre>
18    </div>
19<h2>Parameters</h2>
20    <div class="section">
21      <table class="arguments">
22        <thead>
23          <tr>
24            <td width="15" />
25<th>Name</th>
26<td>Description</td>
27          </tr>
28        </thead>
29        <tr>
30<td>in</td>
31<th>size</th>
32<td>Specifies the file size.</td>
33        </tr> </table>
34    </div>
35<h2>Return Values</h2>
36    <div class="section">
37None.
38               </div>
39<h2>Description</h2>
40    <div class="section">
41<p>Sets the file size.</p><p>
42This function is implemented to show an error screen when errors occur internally, whether or not such errors are fatal. Control does not return from the function in this case. Use <CODE><a href="../../../nn/fs/FileOutputStream/TrySetSize.html">nn::fs::FileOutputStream::TrySetSize</a></CODE> on everything other than ROM archives.
43            </p><p>
44To read details about error handling, see <a href="../briefing/aboutErrorHandling.html#FileAndDirectory">Handling Errors During File and Directory Operations</a>.
45</p><h3>Note 1</h3><div class="section">
46After the size of the file has been extended, if nothing has been written to that region then in principle the process of reading that region returns <CODE><a href="../../../nn/fs/ResultVerificationFailed/Overview.html">nn::fs::ResultVerificationFailed</a></CODE>.
47</div><h3>Note 2</h3><div class="section">
48This function cannot be called for expanded save data. The function will return an error if called in this way. See <a href="../briefing/aboutArchive.html#Archives_ExtSaveDataArchive">Archives</a> for details about expanded save data.
49            </div></div>
50<h2>Revision History</h2>
51    <div class="section">
52      <dl class="history">
53        <dt>2011/10/25</dt>
54<dd>Added note about calling for expanded save data.
55        </dd>
56        <dt>2010/12/24</dt>
57<dd>Added a <B>Note</B>.<br />Added a link to the page about error handling.<br />
58        </dd>
59        <dt>2010/01/29</dt>
60<dd>Initial version.<br />
61        </dd>
62      </dl>
63    </div>
64  <hr><p>CONFIDENTIAL</p></body>
65</html>