File: ReadmeTxt.h

package info (click to toggle)
darkradiant 3.9.0-1
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid, trixie
  • size: 41,080 kB
  • sloc: cpp: 264,743; ansic: 10,659; python: 1,852; xml: 1,650; sh: 92; makefile: 21
file content (49 lines) | stat: -rw-r--r-- 1,273 bytes parent folder | download | duplicates (5)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
#pragma once

#include <stdexcept>
#include "MissionInfoTextFile.h"

namespace map
{

class ReadmeTxt;
typedef std::shared_ptr<ReadmeTxt> ReadmeTxtPtr;

/**
* An object representing the readme.txt file as found in the
* mission folder's root directory. It contains detailed info
* and/or instructions for the player installing the mission.
*/
class ReadmeTxt :
	public MissionInfoTextFile
{
private:
	std::string _contents;

public:
	static const char* NAME()
	{
		return "readme.txt";
	}

	std::string getFilename() override;

	const std::string& getContents();
	void setContents(const std::string& contents);

	// Named constructor parsing the given string into a DarkmodTxt instance
	// A parse exception will be thrown if the file is not compliant
	static ReadmeTxtPtr CreateFromString(const std::string& contents);

	// Named constructor parsing the given stream into a DarkmodTxt instance
	// A parse exception will be thrown if the file is not compliant
	static ReadmeTxtPtr CreateFromStream(std::istream& stream);

	// A parse exception will be thrown if the file is not compliant
	static ReadmeTxtPtr LoadForCurrentMod();

	// Retrieves the text representation of this instance, as it will be written to the readme.txt file
	std::string toString() override;
};

}