Added cFile:ChangeFileExt() function.

MCServer/Plugins/APIDump/APIDesc.lua

@@ -973,6 +973,7 @@ cFile:Delete("/usr/bin/virus.exe");
 			]],
 			Functions =
 			{
+				ChangeFileExt = { Params = "FileName, NewExt", Return = "string", Notes = "(STATIC) Returns FileName with its extension changed to NewExt. FileName may contain path elements, extension is recognized as the last dot in the string." },
 				Copy = { Params = "SrcFileName, DstFileName", Return = "bool", Notes = "(STATIC) Copies a single file to a new destination. Returns true if successful. Fails if the destination already exists." },
 				CreateFolder = { Params = "FolderName", Return = "bool", Notes = "(STATIC) Creates a new folder. Returns true if successful." },
 				Delete = { Params = "FileName", Return = "bool", Notes = "(STATIC) Deletes the specified file. Returns true if successful." },

src/OSSupport/File.cpp

@@ -453,6 +453,29 @@ AString cFile::ReadWholeFile(const AString & a_FileName)
 
 
 
+AString cFile::ChangeFileExt(const AString & a_FileName, const AString & a_NewExt)
+{
+	auto res = a_FileName;
+	auto DotPos = res.rfind('.');
+	if (DotPos == AString::npos)
+	{
+		// No extension, just append it:
+		res.push_back('.');
+		res.append(a_NewExt);
+	}
+	else
+	{
+		// Replace existing extension:
+		res.erase(DotPos + 1, AString::npos);
+		res.append(a_NewExt);
+	}
+	return res;
+}
+
+
+
+
+
 int cFile::Printf(const char * a_Fmt, ...)
 {
 	AString buf;

src/OSSupport/File.h

@@ -127,6 +127,10 @@ public:
 	/** Returns the entire contents of the specified file as a string. Returns empty string on error. */
 	static AString ReadWholeFile(const AString & a_FileName);
 
+	/** Returns a_FileName with its extension changed to a_NewExt.
+	a_FileName may contain path specification. */
+	static AString ChangeFileExt(const AString & a_FileName, const AString & a_NewExt);
+
 	// tolua_end
 	
 	/** Returns the list of all items in the specified folder (files, folders, nix pipes, whatever's there). */