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>CreateFile</title>
8  </head>
9  <body>
10<h1><CODE><a href="../../nn/Overview.html">nn</a>::<a href="../../nn/fs/Overview.html">fs</a>::CreateFile</CODE> Function</h1>
11<h2>Syntax</h2>
12    <div class="section">
13      <pre class="definition">
14void CreateFile(
15     const char * pathName,
16     <a href="../../nn_types/s64.html">s64</a> size
17);
18</pre>
19    </div>
20<h2>Arguments</h2>
21    <div class="section">
22      <table class="arguments">
23        <thead>
24          <tr>
25            <td width="15" />
26<th>Name</th>
27<td>Description</td>
28          </tr>
29        </thead>
30        <tr>
31<td>in</td>
32<th>pathName</th>
33<td>Path of the file to create.</td>
34        </tr>
35        <tr>
36<td>in</td>
37<th>size</th>
38<td>Size of the file to create.</td>
39        </tr> </table>
40    </div>
41<h2>Return Values</h2>
42    <div class="section">
43None.
44               </div>
45<h2>Description</h2>
46    <div class="section">
47<p>Creates a file.</p><p><BR><B>Note:</B> This function uses a large amount of buffer space on the stack because it converts the path name from a multibyte character string into a wide character string. Pay careful attention to the stack size.</p><p>
48This 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/TryCreateFile.html">nn::fs::TryCreateFile</a></CODE> on everything other than ROM archives.
49            </p><p>
50To read details about error handling, see <a href="briefing/aboutErrorHandling.html#FileAndDirectory">Handling Errors During File and Directory Operations</a>.
51</p><h3>Note</h3><div class="section">
52After the size has been extended with this function, if nothing has been written to that region, then in principle the process of reading that region will return <a href="../../nn/fs/ResultVerificationFailed/Overview.html"><CODE>nn::fs::ResultVerificationFailed</CODE></a>. However, if this function is called for save data or expanded save data, then the first 512 bytes (or the entire file if the size is 512 bytes or smaller) are guaranteed to be zero-initialized. By using this and writing to the file in the order (Create file &gt; Write data and flush &gt; Write file signature to front and flush), you can check that the file signature has been loaded correctly and guarantee that the file is written correctly.
53            </div></div>
54<h2>Revision History</h2>
55    <div class="section">
56      <dl class="history">
57        <dt>2011/02/21</dt>
58<dd>Explained that the first 512 bytes are zero-filled.<br />
59        </dd>
60        <dt>2010/12/24</dt>
61<dd>Added a <B>Note</B>.<br />Added a link to the page about error handling.<br />
62        </dd>
63        <dt>2010/11/09</dt>
64<dd>Initial version.<br />
65        </dd>
66      </dl>
67    </div>
68  <hr><p>CONFIDENTIAL</p></body>
69</html>