feat(file): implement support for writing formatted strings to a file

Author: Mauller

Core/GameEngine/Include/Common/LocalFile.h

@@ -55,7 +55,7 @@
 #include "Common/file.h"
 
 #if USE_BUFFERED_IO
-#include <stdio.h>
+#include "Utility/stdio_adapter.h"
 #endif
 
 //----------------------------------------------------------------------------
@@ -100,6 +100,8 @@ class LocalFile : public File
 		virtual void	close( void );																			///< Close the file
 		virtual Int		read( void *buffer, Int bytes );										///< Read the specified number of bytes in to buffer: See File::read
 		virtual Int		write( const void *buffer, Int bytes );							///< Write the specified number of bytes from the buffer: See File::write
+		virtual Int		writeFormat( const Char* format, ... );							///< Write an unterminated formatted string to the file
+		virtual Int		writeFormat( const WideChar* format, ... );						///< Write an unterminated formatted string to the file
 		virtual Int		seek( Int new_pos, seekMode mode = CURRENT );				///< Set file position: See File::seek
 		virtual Bool	flush();													///< flush data to disk
 		virtual void	nextLine(Char *buf = NULL, Int bufSize = 0);				///< moves file position to after the next new-line

Core/GameEngine/Include/Common/RAMFile.h

@@ -91,6 +91,8 @@ class RAMFile : public File
 		virtual void	close( void );																			///< Close the file
 		virtual Int		read( void *buffer, Int bytes );										///< Read the specified number of bytes in to buffer: See File::read
 		virtual Int		write( const void *buffer, Int bytes );							///< Write the specified number of bytes from the buffer: See File::write
+		virtual Int		writeFormat( const Char* format, ... );							///< Write the formatted string to the file
+		virtual Int		writeFormat( const WideChar* format, ... );						///< Write the formatted string to the file
 		virtual Int		seek( Int new_pos, seekMode mode = CURRENT );				///< Set file position: See File::seek
 		virtual Bool	flush();													///< flush data to disk
 		virtual void	nextLine(Char *buf = NULL, Int bufSize = 0);				///< moves current position to after the next new-line

Core/GameEngine/Include/Common/file.h

@@ -153,6 +153,14 @@ class File : public MemoryPoolObject
 																																			  *	 memory pointed at by buffer to the file. Returns the number of bytes written.
 																																			  *	 Returns -1 if an error occurred.
 																																			  */
+		virtual Int		writeFormat( const Char* format, ... ) = 0 ;						/**< Write an unterminated formatted string to the file
+																																			  *	 Returns the number of bytes written.
+																																			  *	 Returns -1 if an error occurred.
+																																			  */
+		virtual Int		writeFormat( const WideChar* format, ... ) = 0 ;						/**< Write an unterminated formatted wide character string to the file
+																																			  *	 Returns the number of bytes written.
+																																			  *	 Returns -1 if an error occurred.
+																																			  */
 		virtual Int		seek( Int bytes, seekMode mode = CURRENT ) = 0;	/**< Sets the file position of the next read/write operation. Returns the new file
 																																				*  position as the number of bytes from the start of the file.
 																																				*  Returns -1 if an error occurred.

Core/GameEngine/Source/Common/System/LocalFile.cpp

@@ -47,7 +47,6 @@
 
 #include "PreRTS.h"
 
-#include <stdio.h>
 #include <fcntl.h>
 #include <io.h>
 #include <string.h>
@@ -381,6 +380,38 @@ Int LocalFile::write( const void *buffer, Int bytes )
 	return ret;
 }
 
+//=================================================================
+// LocalFile::writeFormat - Ascii
+//=================================================================
+
+Int LocalFile::writeFormat( const Char* format, ... )
+{
+	char buffer[1024];
+
+	va_list args;
+	va_start(args, format);
+	Int length = vsnprintf(buffer, sizeof(buffer), format, args);
+	va_end(args);
+
+	return write( buffer, length );
+}
+
+//=================================================================
+// LocalFile::writeFormat - Wide character
+//=================================================================
+
+Int LocalFile::writeFormat( const WideChar* format, ... )
+{
+	WideChar buffer[1024];
+
+	va_list args;
+	va_start(args, format);
+	Int length = vswprintf(buffer, sizeof(buffer) / sizeof(WideChar), format, args);
+	va_end(args);
+
+	return write( buffer, length * sizeof(WideChar) );
+}
+
 //=================================================================
 // LocalFile::seek 
 //=================================================================

Core/GameEngine/Source/Common/System/RAMFile.cpp

@@ -294,6 +294,24 @@ Int RAMFile::write( const void *buffer, Int bytes )
 	return -1;
 }
 
+//=================================================================
+// RAMFile::writeFormat - Ascii
+//=================================================================
+
+Int RAMFile::writeFormat( const Char* format, ... )
+{
+	return -1;
+}
+
+//=================================================================
+// RAMFile::writeFormat - Wide character
+//=================================================================
+
+Int RAMFile::writeFormat( const WideChar* format, ... )
+{
+	return -1;
+}
+
 //=================================================================
 // RAMFile::seek 
 //=================================================================