nn::fs::FileStream::TryWrite Member Function

virtual Result TryWrite(
     s32 * pOut,
     const void * buffer,
     size_t size,
     bool flush
);

	Name	Description
out	pOut	Stores the actual number of bytes that were written.
in	buffer	Pointer to the buffer that contains the data to write.
in	size	Maximum number of bytes to write to the file.
in	flush	Specifies whether to flush data.

Returns the result of the operation.

Writes the specified amount of data from a buffer to a file.

Up to size bytes of data are written to the file from the region at the address specified by buffer.

Data is not flushed if false is specified for flush. If multiple writes to the same file are to be made consecutively, call the TryFlush function after making all writes with flush = false. Then create a buffer to be managed by the system in low-level storage.

Do not write-access the memory of the specified buffer region during this function call (for example, from another thread). File writes may be incorrect and the program could stop working in a future version of the SDK.

Error handling will differ, depending on the archive. For details, see Handling Errors During File and Directory Operations.

2011/03/18

Added note about limitations on buffer access during function call.

2010/12/22

Added a link to the error handling page.

2010/10/05

Corrected the text.

2010/06/14

Initial version.