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>FileOutputStream</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>::FileOutputStream</CODE> Constructor</h1>
11<h2>Syntax</h2>
12    <div class="section">
13      <pre class="definition">
14FileOutputStream();
15
16FileOutputStream(
17     const wchar_t * pathName,
18     bool createIfNotExist
19);
20
21FileOutputStream(
22     const char * pathName,
23     bool createIfNotExist
24);
25</pre>
26    </div>
27<h2>List of Overloaded Member Functions</h2>
28    <div class="section">
29      <table class="members">
30        <tr>
31          <td>
32<a href="./FileOutputStream(0).html">FileOutputStream (  ) </a>
33          </td>
34<td>Constructor.</td>
35        </tr>
36        <tr>
37          <td>
38<a href="./FileOutputStream(1).html">FileOutputStream ( const wchar_t *, bool ) </a>
39          </td>
40<td>A constructor that constructs an object and opens the specified file.</td>
41        </tr>
42        <tr>
43          <td>
44<a href="./FileOutputStream(2).html">FileOutputStream ( const char *, bool ) </a>
45          </td>
46<td>A constructor that constructs an object and opens the specified file.</td>
47        </tr> </table>
48    </div>
49<h2>Description of FileOutputStream (  )</h2>
50<div class="section"><p>In the overloaded version without arguments, no file will be opened. You must call the <a href="../../../nn/fs/FileOutputStream/TryInitialize.html"><CODE>TryInitialize</CODE></a> function separately to manipulate files.</p><p>In the overloaded version with the path name specified, it opens the file at the specified path with write-only access and enables writing.</p><h3>Important</h3><div class="section">
51For expanded save data, you must explicitly create a file using the <a href="../../../nn/fs/TryCreateFile.html"><CODE>nn::fs::TryCreateFile</CODE></a> function before calling this function. <B>Note:</B> Specifying <CODE>true</CODE> for <SPAN class="arg">createIfNotExist</SPAN> when using expanded save data will cause an error. See <a href="../briefing/aboutArchive.html#Archives_ExtSaveDataArchive">Archives</a> for details about expanded save data.
52            </div></div>
53<h2>Description of FileOutputStream ( const wchar_t *, bool )</h2>
54<div class="section"><p>Opens the file in the specified path with write-only access and enables writing. If the <SPAN class="argument">createIfNotExist</SPAN> argument has been set to <CODE>true</CODE> and no file exists in the specified path, this function creates the file and opens it write-only.</p><h3>Important</h3><div class="section">
55For expanded save data, you must explicitly create a file using the <a href="../../../nn/fs/TryCreateFile.html"><CODE>nn::fs::TryCreateFile</CODE></a> function before calling this function. <B>Note:</B> Specifying <CODE>true</CODE> for <SPAN class="arg">createIfNotExist</SPAN> when using expanded save data will cause an error. See <a href="../briefing/aboutArchive.html#Archives_ExtSaveDataArchive">Archives</a> for details about expanded save data.
56            </div></div>
57<h2>Description of FileOutputStream ( const char *, bool )</h2>
58<div class="section"><p>Opens the file in the specified path with write-only access and enables writing. If the <SPAN class="argument">createIfNotExist</SPAN> argument has been set to <CODE>true</CODE> and no file exists in the specified path, this function creates the file and opens it write-only.</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><h3>Important</h3><div class="section">
59For expanded save data, you must explicitly create a file using the <a href="../../../nn/fs/TryCreateFile.html"><CODE>nn::fs::TryCreateFile</CODE></a> function before calling this function. <B>Note:</B> Specifying <CODE>true</CODE> for <SPAN class="arg">createIfNotExist</SPAN> when using expanded save data will cause an error. See <a href="../briefing/aboutArchive.html#Archives_ExtSaveDataArchive">Archives</a> for details about expanded save data.
60            </div></div>
61  <hr><p>CONFIDENTIAL</p></body>
62</html>