minetest/src/settings.h

810 lines
16 KiB
C
Raw Normal View History

2011-10-12 12:53:38 +02:00
/*
2013-02-24 18:40:43 +01:00
Minetest
2013-02-24 19:38:45 +01:00
Copyright (C) 2010-2013 celeron55, Perttu Ahola <celeron55@gmail.com>
2011-10-12 12:53:38 +02:00
This program is free software; you can redistribute it and/or modify
it under the terms of the GNU Lesser General Public License as published by
the Free Software Foundation; either version 2.1 of the License, or
2011-10-12 12:53:38 +02:00
(at your option) any later version.
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU Lesser General Public License for more details.
2011-10-12 12:53:38 +02:00
You should have received a copy of the GNU Lesser General Public License along
2011-10-12 12:53:38 +02:00
with this program; if not, write to the Free Software Foundation, Inc.,
51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
*/
#ifndef SETTINGS_HEADER
#define SETTINGS_HEADER
2012-06-17 03:00:31 +02:00
#include "irrlichttypes_bloated.h"
#include "exceptions.h"
2011-10-12 12:53:38 +02:00
#include <string>
2013-09-16 05:00:01 +02:00
#include "jthread/jmutex.h"
#include "jthread/jmutexautolock.h"
2011-10-12 12:53:38 +02:00
#include "strfnd.h"
#include <iostream>
#include <fstream>
#include <sstream>
#include "debug.h"
#include "log.h"
#include "util/string.h"
#include "util/serialize.h"
2012-12-20 18:19:49 +01:00
#include <list>
#include <map>
#include <set>
#include "filesys.h"
#include <cctype>
2011-10-12 12:53:38 +02:00
enum ValueType
{
VALUETYPE_STRING,
VALUETYPE_FLAG // Doesn't take any arguments
};
struct ValueSpec
{
ValueSpec(ValueType a_type, const char *a_help=NULL)
{
type = a_type;
help = a_help;
}
ValueType type;
const char *help;
};
class Settings
{
public:
Settings()
{
}
void writeLines(std::ostream &os) const
2011-10-12 12:53:38 +02:00
{
JMutexAutoLock lock(m_mutex);
for(std::map<std::string, std::string>::const_iterator
2012-12-20 18:19:49 +01:00
i = m_settings.begin();
i != m_settings.end(); ++i)
2011-10-12 12:53:38 +02:00
{
2012-12-20 18:19:49 +01:00
std::string name = i->first;
std::string value = i->second;
2011-10-12 12:53:38 +02:00
os<<name<<" = "<<value<<"\n";
}
}
Basic support for configuring which mods to load for each world settings.h: added function to return all keys used in settings, and a function to remove a setting mods.{h,cpp}: added class ModConfiguration that represents a subset of the installed mods. server.{h,cpp}: server does not load add-on mods that are disabled in the world.mt file. mods are disabled by a setting of the form "load_mod_<modname> = false". if no load_mod_<modname> = ... setting is found, the mod is loaded anyways for backwards compatibilty. server also complains to errorstream about mods with unstatisfied dependencies and about mods that are not installed. guiConfigureWorld.{h,cpp}: shows a treeview of installed add-on mods and modpacks with little icons in front of their name indicating their status: a checkmark for enabled mods, a cross for disabled mods, a question mark for "new" mods Mods can be enabled/disabled by a checkbox. Mods also show a list of dependencies and reverse dependencies. double-click on a mod in dependency or reverse dependency listbox selects the corresponding mod. Enabling a mod also enables all its dependencies. Disabling a mod also disables all its reverse dependencies. For modpacks, show buttons to enable/disable all mods (recursively, including their dependencies) in it. Button "Save" saves the current settings to the world.mt file and returns to the main menu. Button "Cancel" returns to main menu without saving. basic keyboard controls (if the proper widget has keyboard focus): up/down: scroll through tree of mods left/right: collaps/expand a modpack space: enable/disable the selected mod
2012-12-08 18:10:54 +01:00
2013-12-01 01:52:06 +01:00
// return all keys used
std::vector<std::string> getNames() const
{
Basic support for configuring which mods to load for each world settings.h: added function to return all keys used in settings, and a function to remove a setting mods.{h,cpp}: added class ModConfiguration that represents a subset of the installed mods. server.{h,cpp}: server does not load add-on mods that are disabled in the world.mt file. mods are disabled by a setting of the form "load_mod_<modname> = false". if no load_mod_<modname> = ... setting is found, the mod is loaded anyways for backwards compatibilty. server also complains to errorstream about mods with unstatisfied dependencies and about mods that are not installed. guiConfigureWorld.{h,cpp}: shows a treeview of installed add-on mods and modpacks with little icons in front of their name indicating their status: a checkmark for enabled mods, a cross for disabled mods, a question mark for "new" mods Mods can be enabled/disabled by a checkbox. Mods also show a list of dependencies and reverse dependencies. double-click on a mod in dependency or reverse dependency listbox selects the corresponding mod. Enabling a mod also enables all its dependencies. Disabling a mod also disables all its reverse dependencies. For modpacks, show buttons to enable/disable all mods (recursively, including their dependencies) in it. Button "Save" saves the current settings to the world.mt file and returns to the main menu. Button "Cancel" returns to main menu without saving. basic keyboard controls (if the proper widget has keyboard focus): up/down: scroll through tree of mods left/right: collaps/expand a modpack space: enable/disable the selected mod
2012-12-08 18:10:54 +01:00
std::vector<std::string> names;
for(std::map<std::string, std::string>::const_iterator
2012-12-20 18:19:49 +01:00
i = m_settings.begin();
i != m_settings.end(); ++i)
Basic support for configuring which mods to load for each world settings.h: added function to return all keys used in settings, and a function to remove a setting mods.{h,cpp}: added class ModConfiguration that represents a subset of the installed mods. server.{h,cpp}: server does not load add-on mods that are disabled in the world.mt file. mods are disabled by a setting of the form "load_mod_<modname> = false". if no load_mod_<modname> = ... setting is found, the mod is loaded anyways for backwards compatibilty. server also complains to errorstream about mods with unstatisfied dependencies and about mods that are not installed. guiConfigureWorld.{h,cpp}: shows a treeview of installed add-on mods and modpacks with little icons in front of their name indicating their status: a checkmark for enabled mods, a cross for disabled mods, a question mark for "new" mods Mods can be enabled/disabled by a checkbox. Mods also show a list of dependencies and reverse dependencies. double-click on a mod in dependency or reverse dependency listbox selects the corresponding mod. Enabling a mod also enables all its dependencies. Disabling a mod also disables all its reverse dependencies. For modpacks, show buttons to enable/disable all mods (recursively, including their dependencies) in it. Button "Save" saves the current settings to the world.mt file and returns to the main menu. Button "Cancel" returns to main menu without saving. basic keyboard controls (if the proper widget has keyboard focus): up/down: scroll through tree of mods left/right: collaps/expand a modpack space: enable/disable the selected mod
2012-12-08 18:10:54 +01:00
{
2012-12-20 18:19:49 +01:00
names.push_back(i->first);
Basic support for configuring which mods to load for each world settings.h: added function to return all keys used in settings, and a function to remove a setting mods.{h,cpp}: added class ModConfiguration that represents a subset of the installed mods. server.{h,cpp}: server does not load add-on mods that are disabled in the world.mt file. mods are disabled by a setting of the form "load_mod_<modname> = false". if no load_mod_<modname> = ... setting is found, the mod is loaded anyways for backwards compatibilty. server also complains to errorstream about mods with unstatisfied dependencies and about mods that are not installed. guiConfigureWorld.{h,cpp}: shows a treeview of installed add-on mods and modpacks with little icons in front of their name indicating their status: a checkmark for enabled mods, a cross for disabled mods, a question mark for "new" mods Mods can be enabled/disabled by a checkbox. Mods also show a list of dependencies and reverse dependencies. double-click on a mod in dependency or reverse dependency listbox selects the corresponding mod. Enabling a mod also enables all its dependencies. Disabling a mod also disables all its reverse dependencies. For modpacks, show buttons to enable/disable all mods (recursively, including their dependencies) in it. Button "Save" saves the current settings to the world.mt file and returns to the main menu. Button "Cancel" returns to main menu without saving. basic keyboard controls (if the proper widget has keyboard focus): up/down: scroll through tree of mods left/right: collaps/expand a modpack space: enable/disable the selected mod
2012-12-08 18:10:54 +01:00
}
2013-12-01 01:52:06 +01:00
return names;
Basic support for configuring which mods to load for each world settings.h: added function to return all keys used in settings, and a function to remove a setting mods.{h,cpp}: added class ModConfiguration that represents a subset of the installed mods. server.{h,cpp}: server does not load add-on mods that are disabled in the world.mt file. mods are disabled by a setting of the form "load_mod_<modname> = false". if no load_mod_<modname> = ... setting is found, the mod is loaded anyways for backwards compatibilty. server also complains to errorstream about mods with unstatisfied dependencies and about mods that are not installed. guiConfigureWorld.{h,cpp}: shows a treeview of installed add-on mods and modpacks with little icons in front of their name indicating their status: a checkmark for enabled mods, a cross for disabled mods, a question mark for "new" mods Mods can be enabled/disabled by a checkbox. Mods also show a list of dependencies and reverse dependencies. double-click on a mod in dependency or reverse dependency listbox selects the corresponding mod. Enabling a mod also enables all its dependencies. Disabling a mod also disables all its reverse dependencies. For modpacks, show buttons to enable/disable all mods (recursively, including their dependencies) in it. Button "Save" saves the current settings to the world.mt file and returns to the main menu. Button "Cancel" returns to main menu without saving. basic keyboard controls (if the proper widget has keyboard focus): up/down: scroll through tree of mods left/right: collaps/expand a modpack space: enable/disable the selected mod
2012-12-08 18:10:54 +01:00
}
// remove a setting
bool remove(const std::string &name)
Basic support for configuring which mods to load for each world settings.h: added function to return all keys used in settings, and a function to remove a setting mods.{h,cpp}: added class ModConfiguration that represents a subset of the installed mods. server.{h,cpp}: server does not load add-on mods that are disabled in the world.mt file. mods are disabled by a setting of the form "load_mod_<modname> = false". if no load_mod_<modname> = ... setting is found, the mod is loaded anyways for backwards compatibilty. server also complains to errorstream about mods with unstatisfied dependencies and about mods that are not installed. guiConfigureWorld.{h,cpp}: shows a treeview of installed add-on mods and modpacks with little icons in front of their name indicating their status: a checkmark for enabled mods, a cross for disabled mods, a question mark for "new" mods Mods can be enabled/disabled by a checkbox. Mods also show a list of dependencies and reverse dependencies. double-click on a mod in dependency or reverse dependency listbox selects the corresponding mod. Enabling a mod also enables all its dependencies. Disabling a mod also disables all its reverse dependencies. For modpacks, show buttons to enable/disable all mods (recursively, including their dependencies) in it. Button "Save" saves the current settings to the world.mt file and returns to the main menu. Button "Cancel" returns to main menu without saving. basic keyboard controls (if the proper widget has keyboard focus): up/down: scroll through tree of mods left/right: collaps/expand a modpack space: enable/disable the selected mod
2012-12-08 18:10:54 +01:00
{
2012-12-20 18:19:49 +01:00
return m_settings.erase(name);
Basic support for configuring which mods to load for each world settings.h: added function to return all keys used in settings, and a function to remove a setting mods.{h,cpp}: added class ModConfiguration that represents a subset of the installed mods. server.{h,cpp}: server does not load add-on mods that are disabled in the world.mt file. mods are disabled by a setting of the form "load_mod_<modname> = false". if no load_mod_<modname> = ... setting is found, the mod is loaded anyways for backwards compatibilty. server also complains to errorstream about mods with unstatisfied dependencies and about mods that are not installed. guiConfigureWorld.{h,cpp}: shows a treeview of installed add-on mods and modpacks with little icons in front of their name indicating their status: a checkmark for enabled mods, a cross for disabled mods, a question mark for "new" mods Mods can be enabled/disabled by a checkbox. Mods also show a list of dependencies and reverse dependencies. double-click on a mod in dependency or reverse dependency listbox selects the corresponding mod. Enabling a mod also enables all its dependencies. Disabling a mod also disables all its reverse dependencies. For modpacks, show buttons to enable/disable all mods (recursively, including their dependencies) in it. Button "Save" saves the current settings to the world.mt file and returns to the main menu. Button "Cancel" returns to main menu without saving. basic keyboard controls (if the proper widget has keyboard focus): up/down: scroll through tree of mods left/right: collaps/expand a modpack space: enable/disable the selected mod
2012-12-08 18:10:54 +01:00
}
2011-10-12 12:53:38 +02:00
bool parseConfigLine(const std::string &line)
{
JMutexAutoLock lock(m_mutex);
2011-10-12 12:53:38 +02:00
std::string trimmedline = trim(line);
2011-11-29 13:13:57 +01:00
// Ignore empty lines and comments
if(trimmedline.size() == 0 || trimmedline[0] == '#')
2011-10-12 12:53:38 +02:00
return true;
//infostream<<"trimmedline=\""<<trimmedline<<"\""<<std::endl;
2011-10-12 12:53:38 +02:00
Strfnd sf(trim(line));
std::string name = sf.next("=");
name = trim(name);
if(name == "")
return true;
2011-10-12 12:53:38 +02:00
std::string value = sf.next("\n");
value = trim(value);
/*infostream<<"Config name=\""<<name<<"\" value=\""
2011-10-12 12:53:38 +02:00
<<value<<"\""<<std::endl;*/
2011-10-12 12:53:38 +02:00
m_settings[name] = value;
2011-10-12 12:53:38 +02:00
return true;
}
2011-10-15 01:28:57 +02:00
void parseConfigLines(std::istream &is, const std::string &endstring)
{
for(;;){
if(is.eof())
break;
std::string line;
std::getline(is, line);
std::string trimmedline = trim(line);
if(endstring != ""){
if(trimmedline == endstring)
break;
}
parseConfigLine(line);
}
}
2011-10-12 12:53:38 +02:00
// Returns false on EOF
bool parseConfigObject(std::istream &is)
{
if(is.eof())
return false;
2011-10-12 12:53:38 +02:00
/*
NOTE: This function might be expanded to allow multi-line
settings.
*/
std::string line;
std::getline(is, line);
//infostream<<"got line: \""<<line<<"\""<<std::endl;
2011-10-12 12:53:38 +02:00
return parseConfigLine(line);
}
/*
Read configuration file
Returns true on success
*/
bool readConfigFile(const char *filename)
{
std::ifstream is(filename);
if(is.good() == false)
return false;
/*infostream<<"Parsing configuration file: \""
<<filename<<"\""<<std::endl;*/
2011-10-12 12:53:38 +02:00
while(parseConfigObject(is));
2011-10-12 12:53:38 +02:00
return true;
}
/*
Reads a configuration object from stream (usually a single line)
and adds it to dst.
2011-10-12 12:53:38 +02:00
Preserves comments and empty lines.
Settings that were added to dst are also added to updated.
key of updated is setting name, value of updated is dummy.
Returns false on EOF
*/
bool getUpdatedConfigObject(std::istream &is,
2012-12-20 18:19:49 +01:00
std::list<std::string> &dst,
std::set<std::string> &updated,
bool &value_changed)
2011-10-12 12:53:38 +02:00
{
JMutexAutoLock lock(m_mutex);
2011-10-12 12:53:38 +02:00
if(is.eof())
return false;
2011-10-12 12:53:38 +02:00
// NOTE: This function will be expanded to allow multi-line settings
std::string line;
std::getline(is, line);
std::string trimmedline = trim(line);
std::string line_end = "";
if(is.eof() == false)
line_end = "\n";
2011-11-29 13:13:57 +01:00
// Ignore empty lines and comments
if(trimmedline.size() == 0 || trimmedline[0] == '#')
2011-10-12 12:53:38 +02:00
{
dst.push_back(line+line_end);
return true;
}
Strfnd sf(trim(line));
std::string name = sf.next("=");
name = trim(name);
if(name == "")
{
dst.push_back(line+line_end);
return true;
}
2011-10-12 12:53:38 +02:00
std::string value = sf.next("\n");
value = trim(value);
2012-12-20 18:19:49 +01:00
if(m_settings.find(name) != m_settings.end())
2011-10-12 12:53:38 +02:00
{
std::string newvalue = m_settings[name];
2011-10-12 12:53:38 +02:00
if(newvalue != value)
{
infostream<<"Changing value of \""<<name<<"\" = \""
2011-10-12 12:53:38 +02:00
<<value<<"\" -> \""<<newvalue<<"\""
<<std::endl;
value_changed = true;
2011-10-12 12:53:38 +02:00
}
dst.push_back(name + " = " + newvalue + line_end);
2012-12-20 18:19:49 +01:00
updated.insert(name);
2011-10-12 12:53:38 +02:00
}
else //file contains a setting which is not in m_settings
value_changed=true;
2011-10-12 12:53:38 +02:00
return true;
}
/*
Updates configuration file
Returns true on success
*/
bool updateConfigFile(const char *filename)
{
infostream<<"Updating configuration file: \""
2011-10-12 12:53:38 +02:00
<<filename<<"\""<<std::endl;
2012-12-20 18:19:49 +01:00
std::list<std::string> objects;
std::set<std::string> updated;
bool something_actually_changed = false;
2011-10-12 12:53:38 +02:00
// Read and modify stuff
{
std::ifstream is(filename);
if(is.good() == false)
{
infostream<<"updateConfigFile():"
2011-10-12 12:53:38 +02:00
" Error opening configuration file"
" for reading: \""
<<filename<<"\""<<std::endl;
}
else
{
while(getUpdatedConfigObject(is, objects, updated,
something_actually_changed));
2011-10-12 12:53:38 +02:00
}
}
2011-10-12 12:53:38 +02:00
JMutexAutoLock lock(m_mutex);
// If something not yet determined to have been changed, check if
// any new stuff was added
if(!something_actually_changed){
for(std::map<std::string, std::string>::const_iterator
2012-12-20 18:19:49 +01:00
i = m_settings.begin();
i != m_settings.end(); ++i)
{
2012-12-20 18:19:49 +01:00
if(updated.find(i->first) != updated.end())
continue;
something_actually_changed = true;
break;
}
}
// If nothing was actually changed, skip writing the file
if(!something_actually_changed){
infostream<<"Skipping writing of "<<filename
<<" because content wouldn't be modified"<<std::endl;
return true;
}
2011-10-12 12:53:38 +02:00
// Write stuff back
{
std::ostringstream ss(std::ios_base::binary);
2011-10-12 12:53:38 +02:00
/*
Write updated stuff
*/
for(std::list<std::string>::const_iterator
2011-10-12 12:53:38 +02:00
i = objects.begin();
2012-12-20 18:19:49 +01:00
i != objects.end(); ++i)
2011-10-12 12:53:38 +02:00
{
ss<<(*i);
2011-10-12 12:53:38 +02:00
}
/*
Write stuff that was not already in the file
*/
for(std::map<std::string, std::string>::const_iterator
2012-12-20 18:19:49 +01:00
i = m_settings.begin();
i != m_settings.end(); ++i)
2011-10-12 12:53:38 +02:00
{
2012-12-20 18:19:49 +01:00
if(updated.find(i->first) != updated.end())
2011-10-12 12:53:38 +02:00
continue;
2012-12-20 18:19:49 +01:00
std::string name = i->first;
std::string value = i->second;
infostream<<"Adding \""<<name<<"\" = \""<<value<<"\""
2011-10-12 12:53:38 +02:00
<<std::endl;
ss<<name<<" = "<<value<<"\n";
}
if(!fs::safeWriteToFile(filename, ss.str()))
{
errorstream<<"Error writing configuration file: \""
<<filename<<"\""<<std::endl;
return false;
2011-10-12 12:53:38 +02:00
}
}
2011-10-12 12:53:38 +02:00
return true;
}
/*
NOTE: Types of allowed_options are ignored
returns true on success
*/
bool parseCommandLine(int argc, char *argv[],
2012-12-20 18:19:49 +01:00
std::map<std::string, ValueSpec> &allowed_options)
2011-10-12 12:53:38 +02:00
{
int nonopt_index = 0;
2011-10-12 12:53:38 +02:00
int i=1;
for(;;)
{
if(i >= argc)
break;
std::string argname = argv[i];
if(argname.substr(0, 2) != "--")
{
// If option doesn't start with -, read it in as nonoptX
if(argname[0] != '-'){
std::string name = "nonopt";
name += itos(nonopt_index);
set(name, argname);
nonopt_index++;
i++;
continue;
}
errorstream<<"Invalid command-line parameter \""
2011-10-12 12:53:38 +02:00
<<argname<<"\": --<option> expected."<<std::endl;
return false;
}
i++;
std::string name = argname.substr(2);
2012-12-20 18:19:49 +01:00
std::map<std::string, ValueSpec>::iterator n;
2011-10-12 12:53:38 +02:00
n = allowed_options.find(name);
2012-12-20 18:19:49 +01:00
if(n == allowed_options.end())
2011-10-12 12:53:38 +02:00
{
errorstream<<"Unknown command-line parameter \""
2011-10-12 12:53:38 +02:00
<<argname<<"\""<<std::endl;
return false;
}
2012-12-20 18:19:49 +01:00
ValueType type = n->second.type;
2011-10-12 12:53:38 +02:00
std::string value = "";
2011-10-12 12:53:38 +02:00
if(type == VALUETYPE_FLAG)
{
value = "true";
}
else
{
if(i >= argc)
{
errorstream<<"Invalid command-line parameter \""
2011-10-12 12:53:38 +02:00
<<name<<"\": missing value"<<std::endl;
return false;
}
value = argv[i];
i++;
}
2011-10-12 12:53:38 +02:00
infostream<<"Valid command-line parameter: \""
2011-10-12 12:53:38 +02:00
<<name<<"\" = \""<<value<<"\""
<<std::endl;
set(name, value);
}
return true;
}
void set(const std::string &name, std::string value)
2011-10-12 12:53:38 +02:00
{
JMutexAutoLock lock(m_mutex);
2011-10-12 12:53:38 +02:00
m_settings[name] = value;
}
void set(const std::string &name, const char *value)
2011-10-12 12:53:38 +02:00
{
JMutexAutoLock lock(m_mutex);
m_settings[name] = value;
}
void setDefault(const std::string &name, std::string value)
2011-10-12 12:53:38 +02:00
{
JMutexAutoLock lock(m_mutex);
2011-10-12 12:53:38 +02:00
m_defaults[name] = value;
}
bool exists(const std::string &name) const
2011-10-12 12:53:38 +02:00
{
JMutexAutoLock lock(m_mutex);
return (m_settings.find(name) != m_settings.end() ||
m_defaults.find(name) != m_defaults.end());
2011-10-12 12:53:38 +02:00
}
std::string get(const std::string &name) const
2011-10-12 12:53:38 +02:00
{
JMutexAutoLock lock(m_mutex);
std::map<std::string, std::string>::const_iterator n;
if ((n = m_settings.find(name)) == m_settings.end())
if ((n = m_defaults.find(name)) == m_defaults.end())
throw SettingNotFoundException(("Setting [" + name + "] not found ").c_str());
2011-10-12 12:53:38 +02:00
2012-12-20 18:19:49 +01:00
return n->second;
2011-10-12 12:53:38 +02:00
}
//////////// Get setting
bool getBool(const std::string &name) const
2011-10-12 12:53:38 +02:00
{
return is_yes(get(name));
}
bool getFlag(const std::string &name) const
2011-10-12 12:53:38 +02:00
{
try {
2011-10-12 12:53:38 +02:00
return getBool(name);
} catch(SettingNotFoundException &e) {
2011-10-12 12:53:38 +02:00
return false;
}
}
float getFloat(const std::string &name) const
2011-10-12 12:53:38 +02:00
{
return stof(get(name));
}
u16 getU16(const std::string &name) const
2011-10-12 12:53:38 +02:00
{
return stoi(get(name), 0, 65535);
}
s16 getS16(const std::string &name) const
2011-10-12 12:53:38 +02:00
{
return stoi(get(name), -32768, 32767);
}
s32 getS32(const std::string &name) const
2011-10-12 12:53:38 +02:00
{
return stoi(get(name));
}
v3f getV3F(const std::string &name) const
2011-10-12 12:53:38 +02:00
{
v3f value;
Strfnd f(get(name));
f.next("(");
value.X = stof(f.next(","));
value.Y = stof(f.next(","));
value.Z = stof(f.next(")"));
return value;
}
v2f getV2F(const std::string &name) const
2011-10-15 01:28:57 +02:00
{
v2f value;
Strfnd f(get(name));
f.next("(");
value.X = stof(f.next(","));
value.Y = stof(f.next(")"));
return value;
}
u64 getU64(const std::string &name) const
2011-10-12 12:53:38 +02:00
{
u64 value = 0;
std::string s = get(name);
std::istringstream ss(s);
ss >> value;
2011-10-12 12:53:38 +02:00
return value;
}
u32 getFlagStr(const std::string &name, const FlagDesc *flagdesc,
u32 *flagmask) const
{
std::string val = get(name);
return std::isdigit(val[0])
? stoi(val)
: readFlagString(val, flagdesc, flagmask);
}
// N.B. if getStruct() is used to read a non-POD aggregate type,
// the behavior is undefined.
bool getStruct(const std::string &name, const std::string &format,
void *out, size_t olen) const
{
std::string valstr;
try {
valstr = get(name);
} catch (SettingNotFoundException &e) {
return false;
}
if (!deSerializeStringToStruct(valstr, format, out, olen))
return false;
return true;
}
//////////// Try to get value, no exception thrown
bool getNoEx(const std::string &name, std::string &val) const
{
try {
val = get(name);
return true;
} catch (SettingNotFoundException &e) {
return false;
}
}
// N.B. getFlagStrNoEx() does not set val, but merely modifies it. Thus,
// val must be initialized before using getFlagStrNoEx(). The intention of
// this is to simplify modifying a flags field from a default value.
bool getFlagStrNoEx(const std::string &name, u32 &val, FlagDesc *flagdesc) const
{
try {
u32 flags, flagmask;
flags = getFlagStr(name, flagdesc, &flagmask);
val &= ~flagmask;
val |= flags;
return true;
} catch (SettingNotFoundException &e) {
return false;
}
}
bool getFloatNoEx(const std::string &name, float &val) const
{
try {
val = getFloat(name);
return true;
} catch (SettingNotFoundException &e) {
return false;
}
}
bool getU16NoEx(const std::string &name, int &val) const
{
try {
val = getU16(name);
return true;
} catch (SettingNotFoundException &e) {
return false;
}
}
bool getU16NoEx(const std::string &name, u16 &val) const
{
try {
val = getU16(name);
return true;
} catch (SettingNotFoundException &e) {
return false;
}
}
bool getS16NoEx(const std::string &name, int &val) const
{
try {
val = getU16(name);
return true;
} catch (SettingNotFoundException &e) {
return false;
}
}
bool getS16NoEx(const std::string &name, s16 &val) const
{
try {
val = getS16(name);
return true;
} catch (SettingNotFoundException &e) {
return false;
}
}
bool getS32NoEx(const std::string &name, s32 &val) const
{
try {
val = getS32(name);
return true;
} catch (SettingNotFoundException &e) {
return false;
}
}
bool getV3FNoEx(const std::string &name, v3f &val) const
{
try {
val = getV3F(name);
return true;
} catch (SettingNotFoundException &e) {
return false;
}
}
bool getV2FNoEx(const std::string &name, v2f &val) const
{
try {
val = getV2F(name);
return true;
} catch (SettingNotFoundException &e) {
return false;
}
}
bool getU64NoEx(const std::string &name, u64 &val) const
{
try {
val = getU64(name);
return true;
} catch (SettingNotFoundException &e) {
return false;
}
}
//////////// Set setting
// N.B. if setStruct() is used to write a non-POD aggregate type,
// the behavior is undefined.
bool setStruct(const std::string &name, const std::string &format, void *value)
{
std::string structstr;
if (!serializeStructToString(&structstr, format, value))
return false;
set(name, structstr);
return true;
}
void setFlagStr(const std::string &name, u32 flags,
const FlagDesc *flagdesc, u32 flagmask)
{
set(name, writeFlagString(flags, flagdesc, flagmask));
}
void setBool(const std::string &name, bool value)
2011-10-12 12:53:38 +02:00
{
set(name, value ? "true" : "false");
2011-10-12 12:53:38 +02:00
}
void setFloat(const std::string &name, float value)
2011-10-12 12:53:38 +02:00
{
set(name, ftos(value));
}
void setV3F(const std::string &name, v3f value)
2011-10-12 12:53:38 +02:00
{
std::ostringstream os;
os<<"("<<value.X<<","<<value.Y<<","<<value.Z<<")";
set(name, os.str());
}
void setV2F(const std::string &name, v2f value)
2011-10-15 01:28:57 +02:00
{
std::ostringstream os;
os<<"("<<value.X<<","<<value.Y<<")";
set(name, os.str());
}
void setS16(const std::string &name, s16 value)
{
set(name, itos(value));
}
void setS32(const std::string &name, s32 value)
{
set(name, itos(value));
}
void setU64(const std::string &name, u64 value)
2011-10-12 12:53:38 +02:00
{
std::ostringstream os;
os<<value;
set(name, os.str());
}
void clear()
{
JMutexAutoLock lock(m_mutex);
2011-10-12 12:53:38 +02:00
m_settings.clear();
m_defaults.clear();
}
void updateValue(const Settings &other, const std::string &name)
2011-10-15 01:28:57 +02:00
{
if (&other == this)
2011-10-15 01:28:57 +02:00
return;
JMutexAutoLock lock(m_mutex);
try {
2011-10-15 01:28:57 +02:00
std::string val = other.get(name);
m_settings[name] = val;
} catch (SettingNotFoundException &e) {
2011-10-15 01:28:57 +02:00
}
return;
}
void update(const Settings &other)
2011-10-15 01:28:57 +02:00
{
if (&other == this)
return;
2011-10-15 01:28:57 +02:00
JMutexAutoLock lock(m_mutex);
JMutexAutoLock lock2(other.m_mutex);
2012-12-20 18:19:49 +01:00
m_settings.insert(other.m_settings.begin(), other.m_settings.end());
m_defaults.insert(other.m_defaults.begin(), other.m_defaults.end());
2011-10-15 01:28:57 +02:00
return;
}
Settings & operator+=(const Settings &other)
2011-10-12 12:53:38 +02:00
{
2012-12-20 18:19:49 +01:00
update(other);
2011-10-12 12:53:38 +02:00
return *this;
}
Settings & operator=(const Settings &other)
2011-10-12 12:53:38 +02:00
{
if (&other == this)
return *this;
2011-10-12 12:53:38 +02:00
JMutexAutoLock lock(m_mutex);
JMutexAutoLock lock2(other.m_mutex);
2011-10-12 12:53:38 +02:00
clear();
update(other);
2011-10-12 12:53:38 +02:00
return *this;
}
private:
2012-12-20 18:19:49 +01:00
std::map<std::string, std::string> m_settings;
std::map<std::string, std::string> m_defaults;
2011-10-12 12:53:38 +02:00
// All methods that access m_settings/m_defaults directly should lock this.
mutable JMutex m_mutex;
2011-10-12 12:53:38 +02:00
};
#endif